永 不 满足 、 锐 意 进取 的 工程 师 团队 是 联想 创新 的 生力军 ， 工 程 师 许 奔 正 是 这 支 团队 的 一 个 缩影 。 
许 奔 是 专利 达 人 ， 也 是 创新 狂人 ， 不 仅 自己 提交 了 很 多 专利 点 子 ， 还 带动 团队 脑力 激荡 ; 不 仅 自己 有 创新 的 火花 ， 还 要 去 点 亮 别 人 。 
在 繁忙 的 工作 之 余 ， 许 奔 完 成 了 这 本 书 ， 把 Android 自 动 化 测试 话题 用 卡通 和 对 话 来 表现 ， 这 应 该 是 专业 书籍 里 最 引人入胜 的 一 本 了 吧 。 


为 许 奔 点 赞 ， 为 总 在 学 习 、 总 在 进步 、 总 在 分 享 的 联想 工程 师 们 点 赞 ! 


qeu 


KARAEFKÉCEO 杨元庆 


在 当今 ， 很 少 人 愿意 潜 下 心 来 ， 钻 研一 项 专利 ， 总 结 工作 经 验 ， 但 许 奔 就 是 这 样 一 个 不 断 追 求 进步 ， 努 力 进 取 的 人 。 我 很 支持 他 和 追逐 自己 的 理想 ， 做 自己 喜欢 的 事 。 他 创作 的 过 程 就 像 我 们 打造 一 款 好 
产品 一 样 ， 不 论 方案 推翻 重 来 多 少 次 ， 付 出 多 少 努力 ， 这 过 程 是 快乐 并 享受 的 。 


这 本 书 是 一 个 资深 工程 师 多 年 来 的 积累 ， 且 深入 浅 出 ， 他 把 看 似 枯 燥 的 测试 技术 讲 得 生动 该 谐 ， 趣 味 横生 ， 易 懂 易 记 。 非 常 适合 期 望 在 Android 测 试 技术 上 进 阶 的 人 阅读 。 
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ZUKCEO #4 


许 奔 是 联想 移动 业务 最 早 一 批 从 事 自 动 化 测试 开发 的 工程 师 ， 给 我 的 第 一 印象 是 他 在 演示 他 们 小 组 自动 化 测试 研究 成 果 时 表现 出 来 的 认真 严谨 的 工程 师 风 范 和 自信 心 。 他 在 自动 化 测试 领域 勤奋 钻研 ， 
开创 性 地 在 联想 早期 APP 测 试 团队 内 采用 Smoke 自动化 测试 工具 ， 搭 建 了 良好 的 测试 基础 平台 ， 并 为 联想 手机 测试 业务 提供 了 长 期 、 有 效 的 支持 。 他 参与 开发 的 手机 老化 测试 与 稳定 性 自动 化 测试 工具 ， 更 是 
对 联想 手机 测试 业务 起 到 支撑 性 作用 。 


非常 高 兴 能 看 到 他 把 多 年 Android 自 动 化 测试 开发 的 实践 体会 沉积 下 来 ， 完 成 了 这 本 书 ; 他 把 Android 自 动 化 测试 专业 知识 用 最 简洁 浅显 的 卡通 和 对 话 方式 活泼 地 展现 给 读者 ， 字 里 行 间 足见 其 敏锐 的 思维 
与 富有 启发 性 的 见解 ; 他 一 直 是 我 们 团队 最 富有 创新 思维 的 工程 师 之 一 ， 他 组 织 创 新 周 会 和 跨 专 业 的 头脑 风暴 ， 引 爆 群 体 创意 激情 ， 营 造 了 良好 的 团队 创新 氛围 。 我 们 为 许 奔 职业 上 所 取得 的 成 就 点 赞 ， 同 
时 也 让 我 们 一 同 在 此 开启 学 习 与 分 享 之 旅 吧 


联想 移动 业务 研发 测试 & 质 量 总 监 ” 洪 明 威 


认识 许 奔 大 约 是 5 年 前 ， 那 时 他 初 来 联 想 手机 研发 团队 ， 负 责 测试 工作 ， 聪 明 、 勤 奋 ， 充 满 热 情 ， 沉 稳 的 外 表 下 ， 总 有 奇 思 妙 想 。5 年 后 的 今天 ， 许 奔 已 是 联想 专利 达 人 和 创新 狂人 ， 不 但 自己 提交 了 很 
多 专利 点 子 和 创新 点 子 ， 更 带动 了 整个 团队 的 创新 热情 与 创新 氛围 ! 甚至 在 紧张 的 工作 压力 下 ， 他 仍旧 将 自己 多 年 自动 化 测试 的 经 验 写 成 这 本 书 。 


之 前 看 过 许多 自动 化 测试 的 专业 书 ， 这 本 卡通 版 本 一 定 给 你 不 一 样 的 感受 ! 书 中 的 主人 公 就 像 一 个 自动 化 测试 领航 员 一 样 ， 让 初次 接触 自动 化 人 的 快速 进入 实战 体验 。 期 待 你 能 够 从 中 有 所 收获 ! 
联想 手机 研发 团队 、 测 试 总 监 & 主 任 工 程 师 高 红 


这 是 一 本 不 空谈 理论 的 Android 自 动 化 测试 领域 的 实战 宝典 。 作 者 是 国内 最 早 一 批 在 该 领域 耕耘 的 专家 之 一 ， 全 书 都 是 他 在 该 领域 摸 旗 滚 打 的 经 验 和 教训 总 结 ， 而 独特 的 撰写 手法 和 视角 正 是 其 探索 历程 
的 体现 。 该 书 不 仅 讲解 了 各 种 自动 化 工具 的 使 用 和 脚本 开发 ,更 从 工具 的 核心 源码 分 析 角 度 进行 了 深度 的 探索 。 


如 果 你 正在 这 个 领域 摸索 前 行 ， 那 么 该 书 一 定 能 让 你 少 走 很 多 弯路 ! 
北京 领 通 科技 有 限 公司 CEO RPE 


许 奔 2007~2011 年 在 职 攻读 中 国 科学 院 大 学 〈 原 “中 国 科学 院 研究 生 院 ”) 软件 工程 硕士 学 位 ， 我 作为 他 的 学 术 导师 ， 见 证 了 他 的 成 长 历程 ， 也 深切 体会 到 “教学 相 长 ”的 含义 。 许 奔 选 修 由 我 主讲 的 
《软件 测试 与 质量 保证 》 与 《高 质量 软件 工程 过 程 》 两 门 课 期 间 ， 经 常 与 我 探讨 他 在 企业 一 线 工 作 中 遇 到 的 软件 测试 方面 的 实践 问题 ， 让 我 受益 匪 浅 ， 既 丰富 了 教学 案例 ， 又 促进 了 理论 与 实践 的 结合 。 也 
是 在 那个 时 候 ， 他 正式 踏 上 了 软件 测试 职业 生涯 。 


2010 年 ， 许 奔 和 我 商量 ， 希 望 借助 MSF (微软 解决 方案 框架 ) 的 思想 ， 总 结 出 一 套 适用 于 软件 外 包 测试 的 过 程 改 进 方案 并 进行 实际 应 用 验证 ， 并 在 此 基础 上 完成 硕士 学 位 论文 工作 。 这 个 想法 颇 有 新 意 
且 具 有 较 高 的 实用 价值 ， 我 完全 赞同 ， 并 从 方法 论 层 面 给 予 支持 。 这 次 改进 过 程 持 续 了 一 年 多 的 时 间 ， 取 得 了 良好 的 成 效 ， 许 奔 也 顺利 完成 论文 并 获得 硕士 学 位 。 


本 书 是 许 奔 利 用 周末 时 间 对 多 年 工作 、 学 习 成 果 的 一 次 总 结 ， 文 笔 风 趣 幽 默 ， 内 容 实 用 。 看 到 他 依然 保持 着 工作 和 学 习 的 激情 ， 为 实现 自己 的 理想 而 全 力 以 赴 ， 我 由 衷 为 他 感到 骄傲 ! 


中 国 科学 院 大 学 教授 ub 


a 
nii 


为 什么 要 写 这 本 书 
2006 年 大 学 毕业 后 ， 我 误 打 误 擅 进 入 软件 测试 行业 。 当 时 公司 没有 多 余 的 人 手 ， 每 个 测试 员 需 要 负责 至 少 一 个 大 型 项 目的 完整 测试 任务 。 为 了 最 大 限度 减轻 工作 量 ， 提 高 工作 效率 ， 我 开始 尝试 通过 
QTP 和 LR 进行 项 目的 自动 化 测试 和 压力 测试 ， 这 也 是 自己 人 生 中 第 一 次 接触 自动 化 工具 。 


2009 年 ， 在 自动 化 测试 领域 摸 爬 滚 打 三 个 年 头 后 ， 我 通过 阅读 相关 书籍 、 自 身 实践 和 论坛 交流 ， 对 QTP 和 LR 工 作 原理 有 了 较为 深入 的 了 解 。 在 看 过 《微软 的 软件 测试 之 道 》 后 ， 进 入 到 微软 谨 入 式 团 
队 ， 开 始 借助 更 为 强大 的 WTT、Xacc 等 自动 化 工具 在 说 入 式 平台 进行 更 深入 的 脚本 和 工具 开发 。 


2011 年 ， 被 第 一 代 联 想 乐 Phone 智 能 手机 深 深 震 握 后 ， 我 投身 到 联想 智能 事业 部 ， 开 始 从 Windows 平 台 转 战 到 Android 平 台 ， 继 续 研究 自动 化 测试 和 单元 测试 。 这 些 年 伴随 着 Android 的 发 展 ， 一 路 风土 
其 中 酸甜苦辣 ， 只 有 同路人 能 体会 。 


从 事 自 动 化 测试 这 十 年 ， 一 直 坚 持 做 实践 笔记 ， 将 Android 平 台 各 自动 化 测试 工具 和 框架 的 使 用 经 验 、 源 码 阅 读 的 心得 ， 以 及 对 框架 二 次 封装 及 相关 工具 开发 的 总 结 和 讨论 ， 全 部 记录 了 下 来 ， 以 备 日 后 


查阅 。 不 知 不 觉 已 经 记录 了 厚 厚 一 本 ， 这 本 笔记 不 仅 在 遇 到 问题 时 给 我 莫大 帮助 ， 也 促使 我 立足 于 这 些 知识 和 经 验 进行 更 深入 的 探索 。 


现在 将 这 本 笔记 集结 成 书 ， 不 仅仅 是 为 了 让 大 家 快速 入 门 ， 少 走 弯路 ， 更 是 为 了 让 大 家 在 实践 中 发 现 书 中 更 多 的 缺漏 和 问题 ， 借 助 这 本 笔记 一 起 向 更 深 的 未 知 世界 探 索 。 让 我 们 打开 探照灯 ， 拿 起 洛阳 
f, IUe 


读者 对 象 
其 实 没 必 要 如 此 细 分 ， 只 要 你 想 读 ， 读 就 是 了 ! 
如 果 非 要 我 分 ， 那 大 致 这 些 朋 友 可 以 读 。 
“ 对 软件 测试 感 兴趣 的 人 。 
“ 对 软件 自动 化 测试 感 兴趣 的 人 。 


: xf Android 自动化 测试 感 兴趣 的 人 。 


如 何 阅读 本 书 
本 书 分 为 4 大 部 分 。 
第 一 部 分 为 基础 篇 (第 1~7 章 ) ， 简 单 介绍 Android 常 用 自动 化 测试 工具 和 框架 的 基本 使 用 技巧 与 相关 理论 ， 帮 助 读者 直接 上 手 操作 这 些 工 具 或 使 用 框架 撰写 自动 化 脚本 。 


第 二 部 分 为 原理 篇 (第 8~13 章 ) ， 通 过 对 Android 常 用 自动 化 测试 工具 和 框架 的 源码 剖析 ， 让 大 家 更 直观 地 了 解 工具 的 运行 原理 。 了 解 原理 有 两 大 好 处 : 第 一 ， 可 以 更 灵活 地 运用 这 些 工 具 和 框架 ， 并 清 
楚 地 知道 应 用 这 些 工具 和 框架 的 局 限 性 ; 第 二 ， 可 以 基于 这 些 源码 更 深入 地 对 工具 和 框架 进行 二 次 开发 。 


第 三 部 分 为 实践 篇 (第 14~18 章 ) ， 通 过 项 目 中 的 各 种 需求 和 实际 问题 来 分 析 工具 的 不 足 ， 从 而 开发 一 些小 工具 或 对 框架 进行 二 次 封装 ， 加 以 补充 。 这 里 只 是 抛砖引玉 ， 希 望 大 家 循 着 这 条 线索 开发 出 
更 多 、 更 实用 的 工具 ， 或 对 框架 进行 更 深入 的 封装 。 


第 四 部 分 为 反思 篇 (第 19~21 章 ) ， 结 合 实际 工作 中 领导 们 提出 的 各 种 问题 进行 深入 讨论 和 反思 ， 这 不 仅仅 是 Android 自 动 化 测试 的 问题 ， 还 是 所 有 软件 自动 化 测试 从 业 人 员 都 在 面临 的 问题 。 
附录 人 A 为 moneky 常 用 键 值 参照 表 ， 方便 大 家 使 用 monkey 开 发 时 查阅 。 


附录 B 为 getProperty() 和 getSystemProperty0 的 说 明 ， 方 便 大 家 对 两 者 进行 对 比分 析 。 
勘误 和 支持 


由 于 笔者 的 水 平 有 限 ， 加 之 编写 时 间 仓 促 ， 书 中 难免 会 出 现 一 些 错误 或 者 不 准确 的 地 方 ， 尽 请 读者 批评 指正 。 为 此 ， 特 意 申 请 微 信 公众 号 : 巴 哥 奔 (请 直接 扫描 下 面 的 微 信 二 维 码 添加 ) 。 如 果 你 有 更 
多 的 宝贵 意见 ， 也 请 通过 公众 号 与 我 联系 ,期待 能 够 得 到 你 们 的 真挚 反馈 。 我 也 将 在 公众 号 上 持续 更 新 本 书 部 分 章节 扫描 版 ， 谢 谢 ! 





献 给 我 生命 中 最 重要 的 四 个 女人 : 我 老 妈 、 我 岳母 、 我 爱人 和 我 女儿 简洁 。 
老 妈 : 您 是 我 生命 中 第 一 个 包容 我 的 人 ， 也 是 给 予 我 鼓励 最 多 的 一 个 人 ， 您 的 鼓励 让 我 每 次 跌倒 都 不 忍 风 总 太 久 ， 您 的 包容 让 我 不 断 息 起 来 继续 前 行 。 


EH: 您 不 仅 给 了 我 一 个 最 适合 我 的 女孩 ， 还 教会 我 如 何 对 这 个 世界 满怀 善意 ， 此 生 能 遇 上 如 此 善良 、 正 直 的 您 ， 我 非常 感动 、 感 激 、 感 思 。 





ER: 你 让 我 深 切 地 感受 到 ， 当 双鱼 座 遇 到 处 女 座 是 一 次 多 么 痛 的 赔 变 ， 你 成 功 地 让 一 条 鱼 抛 开 幻 想 、 面 对 现实 、 别 除 鳞 片 、 割 掉 尾巴 、 长 出 四 肢 ， 成 为 一 个 有 担当 的 男人 ， 感 谢 一 起 走 过 的 12 年 ， 和 


你 慢 慢 变 老 绝对 是 人 生 中 最 浪漫 的 事情 ， 没 有 之 一 。 


简洁 : 和 爸爸 写 这 本 书 的 时 候 你 还 没 出 生 ， 出 版 这 本 书 的 时 候 你 已 经 牙牙 学 语 了 ， 因 为 你 迅速 地 成 长 ， 和 爸爸 真 的 有 种 光阴 似 箭 的 感觉 希望 你 能 身心 健康 地 慢 慢 成 长 ， 用 心 感受 成 长 的 烦恼 和 喜悦 。 


曾经 以 为 ， 将 自己 多 年 奋战 在 一 线 的 自动 化 经 验 稍 作 总 结 ， 就 可 以 变 成 一 本 非常 棒 的 自动 化 实践 指南 。 所 以 当 福 川 邀 请 我 出 书 的 时 候 ， 我 毫 不 犹豫 地 答应 下 来 。 


写 到 1/3 的 时 候 ， 感 觉 自己 快要 前 渍 了 ， 这 上 比 做 任何 一 个 项 目 都 要 难 上 百倍 。 写 书 不 仅 是 一 个 人 的 战斗 ， 还 是 一 个 非常 系统 化 的 工程 一 除非 你 想 随便 糊弄 ， 和 否则 就 必须 将 一 切 推翻 ， 重 新 学 习 ， 重 构 整 


个 体系 。 
写 到 一 半 的 时 候 ， 正 轿 爱 人 怀孕 、 女 儿 出 生 ， 既 幸福 也 前 堵 ， 真 想 彻底 放弃 这 本 书 。 然 而 ， 看 到 爱人 为 孕育 一 个 小 生命 的 努力 和 坚持 ， 一 次 次 地 激励 自己 振作 起 来 继续 战斗 。 


这 本 书 终于 在 女儿 一 岁 时 完成 了 ， 当 最 后 一 章 发 到 福 川 和 姜 影 的 邮箱 时 ， 自 己 的 眼泪 抑制 不 住地 流 消 下 来 。 我 是 一 个 特别 讨厌 炉 情 的 人 ， 但 真 的 只 有 自己 知道 这 个 过 程 多 么 的 艰辛 。 


这 本 书 的 诞生 ， 除 了 家 人 的 支持 ， 必 须 感谢 杨 福 川 和 姜 影 一 直 以 来 的 帮助 ， 还 要 感谢 我 最 好 的 兄弟 邓 凡 平和 李 海 潮 牺 牲 很 多 与 家 人 团聚 的 时 间 对 本 书 反复 审阅 。 团 队 中 那些 给 予 本 书 指导 的 兄弟 姐妹 在 
此 一 并 谢 过 : das. A. AU. BR, A. TOR. MAH. RH. EF. 


在 本 书 即 将 出 版 之 际 ， 得 到 元 庆 和 明 威 为 我 人 生 中 的 第 一 本 书写 推荐 语 ， 感 恩 领 导 ， 感 恩 联想 ! 


AX 


第 一 部 分 “基础 篇 


“ 第 1 章 Android 自 动 化 测试 基础 

“ 第 2 章 稳定 性 测试 利器 monkey 使 用 详解 

. 第 3 章 monkey 之 子 monkeyrunner 使 用 详解 
CASE ”单元 测试 框架 Instrumentation 使 用 详解 
“第 5 章 终极 自动 化 框架 UIAutomator 使 用 详解 
“ 第 6 章 兼容 性 测试 框架 CTS 使 用 详解 


“第 7 章 Android 自 动 化 工具 使 用 总 结 


者 风流， 我 是 船长 ， 许 奔 ， 可 以 叫 我 巴 哥 奔 。 


SEE, RACH, RLZbugben, FARA —N, MRA! 


CBAC 








FRORA 巴 哥 的 房间 








本 书 不 打算 介绍 自动 化 或 Android 的 历史 ， 不 打算 空洞 地 陈述 自动 化 的 分 类 和 演变 过 程 ， 而 是 着 眼 于 具体 实战 ， 以 巴 哥 奔 的 Android 自 动 化 实践 之 路 为 核心 ， 以 Android 自 动 化 源码 分 析 为 基础 ， 以 测试 需 
求 为 引导 ， 带 你 一 步 步 从 Android 官 方 自动 化 工具 或 框架 使 用 到 常用 工具 原理 剖析 ， 再 到 根据 具体 项 目 和 需求 对 框架 或 脚本 做 改进 与 二 次 封装 。 让 大 家 以 战 养 战 ， 不 断 修炼 和 提升 自己 在 Android 自 动 化 领域 的 
功力 。 


当然 ， 正 如 所 有 实战 都 会 出 现 偏颇 、 不 足 和 错漏 一 样 ， 本 书 也 存在 大 量 值得 更 深入 探讨 的 地 方 。 这 点 巴 哥 奔 绝 不 避讳 ， 本 书 的 出 版 与 其 说 是 指导 大 家 深入 钻研 Android 自 动 化 ， 不 如 说 是 设立 一 个 个 供 大 
家 深入 探讨 的 题目 ， 让 大 家 与 巴 哥 奔 一 起 回顾 实践 之 路 ， 避 开 巴 哥 奔 掉 入 的 陷阱 ， 绕 开 巴 哥 奔 钻 进 的 死胡同 ， 笑 笑 巴 哥 奔 抱 着 不 放 的 牛角 尖 ， 最 终 踏 出 一 条 适合 于 自己 的 Android 自 动 化 测试 实践 之 路 。 





另外 ， 本 书 所 有 人 物 图 像 来 自 脸 萌 软 件 ， 对 话 字体 来 自 迷 你 简 卡 通 ， 特 此 感谢 ! 





人 % 巴 哥 奔 图 像 为 作者 专属 ， 仿 冒 必 究 。 
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Android 自 动 化 分 析 


$6, , s. 一 般 情 况 巴 哥 奔 应 该 向 大 家 介绍 如 何 配置 环境 ， 如 何 创建 第 一 个 项 目 ， 如 何 开始 测试 。 

& ue 

全 不 介绍 这 些 还 能 介绍 些 什么 呢 ? 

E Da wd HEE bdo (比如 那些 大 家 在 网 上 即 可 查 到 的 内 容 ) ， 将 不 能 省 略 的 融入 到 具体 章节 中 〈 比 如 针对 具体 项 目的 测试 工程 创建 等 ) 。 
e 

那么， 咱们 本 章 将 聊 些 什么 呢 ? 


eo 巴 哥 奔 打算 按 这 个 顺序 聊 聊 Android 自 动 化 。 


Android 自 动 化 分 析 ， 如 图 1-1 所 示 。 











， 手 里 有 剑 。”' 什么 样 的 兵器 最 称 手 ? 





| 心中 有 剑 ”| 如何 要 好 你 手 上 的 兵器 ? 





- 人 剑 合 一 |o 你 了 解 你 的 兵器 吗 ? 


二 年 磨 剑 “ 所 7 如何 改造 你 的 兵器 ? 


图 1-1 Android 自 动 化 分 析 


eo 


4A LAS AGE RSV 请 说 人 话 ! 
E es, 好 好 玩 ， 奔 哥 解释 一 下 1! 
eo... 那 我 换 一 种 说 法 ! 


如 果 这 样 说 大 家 一 头 雾 水 的 话 ， 巴 哥 奔 可 以 换个 说 法 ， 如 图 1-2 所 示 。 





o5 1. 我 们 需要 什么 样 的 自动 化 框架 ? 





/ ^ 2. 业界 主流 自动 化 框架 的 优 劣势 分 析 





一 一 3. 深入 剖析 业界 主流 自动 化 框架 源码 





~ 
T 


4. 如 何 利用 业界 主流 自动 化 框架 进行 二 次 开发 ? 





图 1-2 Android 自 动 化 再 分 析 
e. 9| AERE! 


SAA, ARW, vhdngpinve! 


12 ”什么 样 的 兵器 最 称 手 


ee 在 做 Android 自 动 化 之 前 ， 先 听 听 领导 们 怎么 说 。 


公司 各 部 门 、 各 团队 领导 们 如 是 说 ， 如 图 1-3 所 示 。 








se 自动 化 从 没 i 
员 为 了 证 明 他 们 取得 过 任何 的 自动 化 框 染 
ZONE f CHE 和 工具 ,根本 
不 用 自己 开 友 
自动 化 只 
会 增加 黑 


xlii, A | nv y 自动 化 工程 


员 的 负担 师 性 价 比 是 
| 最 低 的 





图 1-3 ”各 部 门 领 导 如 是 说 


| CPP: 高 啊 ! 是 不 是 该 反省 一 下 ? 


SOF, ved! g 





呵呵 ， 这 还 只 是 一 方面 ， 自 动 化 团队 不 仅 要 面 对 外 部 团队 的 质疑 ， 还 要 面 对 测 试 团队 内 部 的 抵触 和 不 支持 。 


测试 团队 内 部 的 抵触 和 不 支持 (比如 脚本 执行 团队 的 同志 们 ) 如 图 1-4 所 示 。 



















自动 工具 很 难 
发 现 bug. 


请 大 家 说 说 对 
目 动 化 的 看 法 


做 好 了 是 他 们 的 









很 多 自动 化 工具 门 
成 绩 ， 做 不 好 是 


RECZ, 
处 给 别人 黑 锅 我 
files, BFA. 





自动 化 脚本 运行 效 
率 太 低 ， 还 不 如 我 
手动 跑 呢 ! 






是 啊 ， 又 不 是 咱们 
HAR, AA 
浪费 大 把 时 间 。 





我 们 花 很 多 时 间 来 
使 用 不 相当 于 给 他 












们 工具 做 测试 吗 ? 


图 1-4 测试 团队 内 部 如 是 说 


aux 多 说 什么 了 …… 

pA 

SSF, CAMA ALMA RLM? 

2 eee eres te 测试 人 员 的 学 习 成 本 等 维度 看 ， 问 题 就 更 多 了 。 所 以 说 前 路 漫漫 ，Android 自 动 化 团队 自 成 立 之 初 就 必须 顶 起 这 些 内 忧 外 患 。 
人 A% 那 当 自 动 化 工具 强大 了 、 自 动 化 脚本 数量 上 去 了 ， 是 否 就 能 让 大 家 心悦诚服 ? 


当 Android 自 动 化 工具 兼容 性 、 易 用 性 ， 脚 本 的 覆盖 率 、 移 植 率 都 达到 一 个 新 的 高 度 ， 是 否 就 能 让 工具 、 肢 本 在 实际 工作 中 顺畅 运转 起 来 ? 


eo, BEA TUR 说 白 了 ， 自 动 化 究竟 要 达到 什么 目标 ? 





这 里 ， 巴 哥 奔 将 自动 化 相关 测试 员 分 为 两 类 : 一 类 是 开发 测试 框架 的 测试 员 ， 另 一 类 是 在 实际 项 目 中 利用 框架 编写 和 执行 测试 脚本 的 测试 员 。 
Ga 目标 呢 ， 怎 么 分 起 类 来 了 ? 

Ontan, 自动 化 的 目标 就 是 : 通过 这 两 类 测试 员 的 合力 ， 确 保 项 目测 试 稳定 高 效 地 进行 。 

OO 那 首先 必须 清楚 这 两 类 测试 员 的 痛 点 在 哪里 。 

Oaren 试 框架 的 测试 员 而 言 ， 就 是 如 何 打造 出 一 把 称 手 的 兵器 。 


65, ! 


言 ， 就 是 开发 出 一 款 稳 定性 好 、 可 移植 性 好 、 灵 活性 好 、 支 持 多 应 用 交互 、 运 行 效率 高 的 自动 化 框架 。 





Wed C si 7 p ci p e e MEL e 


本 就 是 如 何 利用 这 把 兵器 干掉 更 多 的 敌人 1! 

65, i 

$6,,.. 需要 的 是 一 款 容易 上 手 、 开 发 效率 高 、 方 便 调试 、 控 件 易 捕获 的 自动 化 框架 。 
Ona, 这 两 方面 的 需求 能 否 都 满足 呢 ? 


, E 如 何 要 好 你 手 上 的 兵器 ? 


1.3 ”如 何 要 好 你 手 上 的 兵器 


到 奔 可 ， 怎 么 才 算 是 要 好 手 上 的 兵器 呢 ? 


eo... 你 必须 了 解 每 一 款 业 界 主流 的 兵器 。 
其 次 ， 你 必须 清楚 每 一 款 主流 兵器 的 优势 和 劣势 分 别 在 哪 ? 
最 后 ， 如 何 最 大 限度 地 利用 兵器 的 优势 ? 


人 《就 是 不 能 只 是 简单 地 说 要 稳定 性 好 、 可 移植 性 好 之 类 的 空话 套话 。 





而 是 要 具体 分 析 什 么 才 叫 稳定 性 好 ， 什 么 才 叫 可 移植 性 好 ， 哪 些 测试 框架 满足 稳定 性 好 这 一 特点 ， 哪 些 不 能 满足 ， 对 吧 ? 


eo... TF THU! 还 是 给 大 家 举 个 例子 加 以 说 明 吧 ! 


以 下 的 描述 肯定 不 全 面 ， 但 能 说 明 问题 。 





1) 稳定 性 好 : 意味 着 尽 可 能 少 地 通过 控件 index 进 行 节点 判断 ， 而 业界 大 部 分 框架 都 以 index 为 主 进行 节点 判断 。 





2) 可 移植 性 好 : 意味 着 尽 可 能 少 地 通过 坐标 进行 控件 定位 ， 而 业界 很 多 框架 (如 monkey、monkeyrunner 等 ) 都 通过 坐标 进行 控件 定位 。 


























3) 支持 多 应 用 交互 : 意味 着 框架 必须 支持 跨 应 用 ， 但 某 些 主流 框架 (如 Instrumentation 等 ) 不 支持 跨 应 


























4) 运行 效率 高 : 意味 着 窗口 跳 转 监控 和 窗口 定位 要 准确 ， 但 很 多 框架 (如 monkey、monkeyrunner 等 ) 都 不 具备 这 个 功能 。 



































5) 容易 上 手 : 意味 着 框架 接口 要 容易 理解 和 掌握 ， 但 大 多 数 框架 (如 monkeyrunner、Instrumentation 等 ) 的 接口 都 不 是 那么 人 性 化 。 











6) 开发 效率 高 : 意味 着 框架 封装 程度 要 高 ， 但 业界 主流 框架 普遍 缺少 封装 或 者 封装 与 项 目 实际 要 求 不 匹配 (如 Robotium 对 Instrumentation 的 封装 ) 。 





7) 方便 调试 : 意味 着 框架 足够 开放 ， 但 大 多 数 框架 (如 monkeyrunner、UIAutomator 等 ) 调试 都 极其 麻烦 。 


























oo 


控件 易 捕获 : 意味 着 框架 对 控件 识别 率 高 、 识 别 稳定 ， 但 有 的 框架 (如 monkey、monkeyrunner 等 ) 对 控件 识别 率 极 差 ， 甚 至 不 具备 控件 识别 能 





哈哈， 清楚 了 ! 知己 知 彼 后 ， 接 下 来 我 们 要 做 什么 呢 ? 


Qo, s 事情 很 多 。 

第 一 ， 我 们 可 以 进行 框架 匹配 ; 

第 二 ， 我 们 可 以 让 多 个 框架 搭配 互补 ; 

第 三 ， 我 们 可 以 对 框架 有 针对 性 的 二 次 封装 ; 


第 四 ， 我 们 可 以 根据 需求 开发 趁 手 的 工具 。 








知己 知 彼 后 ， 如 何 更 好 地 利用 框架 呢 ? 如 图 1-5 所 示 。 

















_ -框架 匹配 “2 将 项 目 具 体 需求 与 业界 主流 框架 进行 匹配 


对 于 某 些 要 求 较 多 的 大 型 项 目 ， 
Pa 多 框架 互补 © 可 以 考虑 多 框架 互补 的 形式 


对 于 具体 项 目的 某 些 特殊 需求 ， 
二 次 封装 O 可 考虑 对 框架 进行 二 次 封装 


基于 现 有 框架 的 原理 ， 分 析 可 以 


图 1-5 如 何 利用 框架 


全 区 前 两 项 还 好 ， 后 两 项 看 上 去 像 Impossible Mission 呢 ! 


eo... 是 的 ， 要 进行 后 两 项 实践 ， 必 须 建立 在 对 框架 深入 了 解 的 基础 上 ， 这 就 引出 了 下 一 个 问题 : 你 了 解 你 的 兵器 吗 ? 


1.4 你 了 解 你 的 兵器 吗 


[ CMMEPPPPPPI 你 是 不 是 认为 自己 已 经 足够 了 解 手 上 的 兵器 了 ? 


当 你 可 以 根据 项 目 需求 灵活 地 搭配 各 种 测试 工具 后 ， 你 是 不 是 认为 兵器 已 经 使 得 得 心 应 手 了 ? 


$ 
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改天 哪 ， 都 没有 …… 那 我 还 缺 什么 呢 ? 


©, 你 缺少 对 兵器 运行 机 制 的 理解 ; 

其 次 ， 你 缺少 对 不 同 兵器 完成 同一 个 任务 时 所 采用 的 不 同方 式 的 理解 ; 

然后 ， 你 缺少 对 兵器 之 所 以 具备 这 个 优势 或 为 什么 会 有 这 样 的 劣势 的 深入 理解 ; 

$5,.. 你 缺少 站 在 兵器 源码 角度 重新 审视 框架 的 能 力 。 

-全 % 那 我 如 何 才能 具备 这 些 能 力 呢 ? 

$9. ans, 没 别 的 ， 必 须 一 头 扎 进 框架 源码 的 海洋 中 ， 去 探索 ， 去 发 现 。 

只 有 对 源码 熟悉 ， 才 可 能 更 直观 地 了 解 框架 运行 机 制 ， 才 能 分 析 不 同 框架 在 处 理 同一 个 操作 时 所 采用 的 不 同方 法 ， 才 可 能 深入 思考 框架 的 优 劣 势 。 
se 
-性 是 不 是 只 有 这 样 才能 真正 做 到 对 框架 的 二 次 封装 ， 或 利用 框架 某 些 特点 开发 出 更 实用 的 小 工具 或 深度 用 例 ? 


eo 的 确 如 此 ! 


1.5 ”如何 改造 你 的 兵器 


eo, 熟悉 源码 后 ， 就 可 以 根据 项 目 实际 需求 进行 框架 封装 、 工 具 开 发 或 深度 用 例 编写 了 。 


ES 


5 


发 不 过 ， 我 们 该 如 何 开始 呢 ? 


j 


什么 时 候 我 们 该 下 定 决心 去 改造 我 们 的 兵器 呢 ? 
Qo, 遇 到 这 些 情况 我 们 可 以 考虑 去 改造 我 们 的 兵器 。 


遇 到 如 下 情况 需要 改造 兵器 。 

















1) 便利 性 : 当 某 款 工 具 用 起 来 不 太 方便 ， 而 我 们 只 需 简单 包装 就 可 以 大 大 降低 其 使 用 门槛 和 出 错 率 、 提 高 其 使 用 效率 时 ， 我 们 可 以 考虑 将 命令 行 工具 封装 为 














2) 临时 性 : 当 某 款 小 工具 常常 需要 针对 当前 任务 的 测试 创造 很 多 临时 性 脚本 〈 即 无 需 考虑 脚本 稳定 性 、 可 移植 性 等 ， 只 需 当 时 、 当 地 成 功 运行 即 可 ) 时 ， 可 以 考虑 将 其 改造 为 能 够 进行 简单 录制 的 小 工 





工具 开发 ”= 开发 哪些 实用 的 小 工具 ， 或 利用 
框架 进行 深度 用 例 的 开发 ( 如 CTS 等 ) 








界面 的 传 参 小 工具 。 




















3) 定制 化 : 当 某 个 框架 需要 针对 大 型 项 目 进行 脚本 深度 开发 和 长 期 维护 ， 而 此 时 业界 对 该 框架 的 封装 难以 满足 具体 项 目 需求 时 ， 可 以 考虑 对 其 进行 定制 化 的 二 次 封装 。 




















4) 针对 性 : 当 项 目 组 常常 根据 需要 频繁 增加 或 改动 某 些 关键 接口 ， 而 这 些 接口 缺少 应 有 的 单元 测试 用 例 进行 支持 时 ， 可 以 考虑 在 相关 框架 下 开发 定制 化 用 例 进行 针对 性 测试 。 














EC] 
SAMAT! 不 过 要 做 到 知行 合 一 还 是 很 难 …… 


e, CARP BUA, 赶快 上 路 吧 ! 


第 2 章 ”稳定 性 测试 和 器 monkey 使 用 详解 





要 想 发 布 新 版 本 ， 先 得 通过 稳定 性 测试 ， 要 想 通 过 稳定 性 测试 ， 先 得 通过 monkey。 


2.1 monkey 概 述 


本 章 巴 哥 奔 将 带 你 进入 Android 稳 定性 测试 利器 一 一 monkey 的 世界 ! 




















你 将 在 本 章 学 到 如 何 通 过 monkey 从 容 应 对 领导 对 于 稳定 性 测试 的 新 想法 ， 学 完 本 章 后 ， 相 信 你 在 遇 到 相关 测试 任务 的 时 候 一 定 能 迅速 找到 入 手 点 并 让 领导 对 你 乔 目 相 看 ! 








2.2 第 一 个 Impossible Mission 


en 定性 测试 的 效率 太 低 了 ， 你 们 想 个 办 法 既 能 快速 模拟 用 户 操作 又 不 需要 增加 人 手 。 
E 
全 必 奔 可 ，BOSS 这 不 是 既 要 马 儿 跑 ， 又 要 马 儿 不 吃 草 吗 ? 
eo 
她 是 这 意思 ， 不 过 咱们 先 来 看 看 如 何 应 对 吧 ! 
s» 
全 既然 要 模拟 用 户 操作 ， 那 用 户 都 有 哪些 操作 呢 ? 


人 Rs 不 是 很 复杂 ， 关 键 是 每 个 平台 的 每 个 版 本 的 每 个 基本 应 用 都 要 测 到 。 


如 果 有 3 个 平台 4 个 版 本 20 款 应 用 的 话 ， 我 每 天 就 得 测 3X4X20=240 个 应 用 ， 如 果 平 均 每 个 应 用 有 30 个 动作 的 话 …… 





s» 
如果 我 们 也 能 随机 发 送 类 似 操作 事件 流 ， 就 能 基本 实现 模拟 用 户 操作 。 不 过 ， 我 们 该 如 何 开始 呢 ? 


2.3 monkey 的 基本 使 用 


e... 进行 Android SD 区 环境 配置 以 便 进 入 adb shell; 
其 次 ， 通 过 命令 行 直 接 运 行 monkey 即 可 。 
monkey 文 档 地 址 为 “<android_sdk>/docs/tools/help/monkey.html” 。 


官网 地 址 : http://developer.android.com/tools/help/monkey.html。 

















monkey 可 以 运行 在 模拟 器 或 实际 设备 中 ， 它 向 系统 发 送 伪 随机 的 用 户 事件 流 (如 按键 输入 、 触 摸 屏 输入 和 手势 输入 等 ) ， 实 现 对 正在 开发 的 应 用 程序 进行 压力 测试 。monkey 测 试 是 一 种 为 了 测试 软件 
的 稳定 性 、 健 壮 性 的 快速 有 效 的 方法 。 























(oa 下 载 Android 源 码 后 ， 你 可 在 “~/development/cmds/monkey/src/com/android/commands/monkey” 路 径 下 找到 monkey 相 关 源 码 ， 巴 哥 奔 将 在 本 书 原理 篇 中 对 其 进行 详细 分 析 。 
就 目前 而 言 ， 你 需要 知道 的 仅仅 是 如 下 两 个 步 又。 
1) 进入 adb shell。 


2) 运行 “/system/bin” 路 径 下 monkey 脚 本 。 














命令 来 表示 ， 如 下 : 





adb shell 
cd/system/bin 
# monkey 


ex 





或 更 直接 地 通过 以 下 命令 运行 





$ adb shell/system/bin/monkey 

















此 时 ，monkey 将 以 无 反馈 模式 启动 ， 并 把 事件 任意 发 送 到 安装 在 目标 环境 中 的 全 部 包 ， 运 行 结果 如 图 2-1 所 示 。 























C:\Documents and Settings\xubeni>adb shell monkey 

adb server is out of date. killing... 

* daemon started successfully x 

usage: monkey [-p ALLOWED_PACKAGE [~p ALLOWED_PACKAGE] ...] 
[-c MAIN_CATEGORY [-c MAIN_CATEGORY] ...1 
[--ignore-crashes] [--ignore-timeouts ] 
[--ignore-security-exceptions ] 
[--monitor-natiue-crashes] [--ignore-natiue-crashes]1] 
[--kill-process-after-error]l [--hprof ] 
[--pct-touch PERCENT] [--pct-motion PERCENT ] 
[--pct-trackball PERCENT] [--pct-syskeys PERCENT ] 
[--pct-nav PERCENT] [--pct-majornauv PERCENT ] 
[--pct-appswitch PERCENT] [--pct-flip PERCENT] 
[--pct-anyevent PERCENT] [--pct-pinchzoom PERCENT] 
[--pkg-blacklist-file PACKAGE BLACKLIST. FILE] 
[--pkg-whitelist-file PACKAGE_WHITELIST_FILE] 
[--vwait-dbg] [--dbg-no-events 1] 
[--setup scriptfilel [-f scriptfile [-f scriptfilel ...] 
[--port port] 
[-s SEED] [-u [-vu] S 
[--throttle MILLISEC] [--randomize-throttle ] 
[--profile-vait MILLISEC] 
[--device-sleep-time MILLISEC] 
[--randomize-script ] 
[--script-10o9g]1] 
[--bugreport 1 
[--periodic-bugreport ] 
COUNT 





图 2-1 monkey 无 参数 时 将 弹出 帮助 信息 
E] 
CH? XH ore ERU? 
o. 大 家 发 现 monkey 并 没有 真正 运行 起 来 ， 只 显示 usage， 说 明 我 们 漏 掉 了 一 个 重要 参数 <event-count> 。 
monkey 命 令 代 码 如 下 。 


$ adb shell monkey <event-count> 


这 里 <event-count> 是 指 随机 发 送 事 件数 。 








主意 ”这 里 <event-count> 是 事件 数 而 不 是 循环 次 数 。 


只 有 当 monkey 传 入 脚本 时 ， 该 值 才 为 循环 次 数 。 


如 果 要 发 送 1000 个 随机 事件 ， 只 需要 运行 如 下 命令 : 


$ adb shell monkey 1000 





monkey 运 行 结 果 如 图 2-2 所 示 。 











C:\Documents and Settings\xubenl>adb shell monkey 1000 
adb server is out of date. killing... 
* daemon started successfully x 
A activityResuming‘com. lenovo. launcher.theme.lovecorner 


// activityResuming(<conm. letv.android.client> 
// activityResuming(com.android.settings>) 

// activityResuming(<com. lenovo.compass) 

// activityResuming<com. lenovo.browser> 
//_activit yResuming(com.android.settings) 





图 2-2 monkey 运 行 时 命令 行 信 息 





这 下 monkey 不 仅 运 行 起 来 了 ， 还 疯狂 地 发 送 了 1000 个 随机 事件 一 一 大 家 应 该 发 现 自己 的 手机 开始 疯狂 运行 了 吧 ，so easy! 


人 % 哇 ， 果 真 跑 起 来 了 ， 这 么 神奇 ? 这 个 脚本 里 究竟 有 哈 奥 妙 ? 








其 实 脚本 本 身 很 简单 ， 如 代码 清单 2-1 所 示 。 














代码 清单 2-1 monkey 脚 本 





base-/system 
export CLASSPATH=$ base/framework/monkey. jar 
exec app_process $ base/bin com.android.commands.monkey.monkey $ * 






































通过 脚本 我 们 不 难 发 现 ， 该 批 处 理 调用 的 是 com.android.commands.monkey.monkey 包 。 如 果 你 希望 定制 monkey 工 具 ， 则 需 修 改 这 个 包 ， 稍 后 原理 篇 将 进行 详 述 。 











作为 SDK 众 多 强大 工具 中 的 一 款 ，monkey 与 大 家 非常 熟悉 的 AVD 管 理 器 (Android AVD) 、 模 拟 器 (Emulator) 和 Dalvik 调 试 监视 器 服务 器 (DDMS) 一 起 随 SDK 入 门 套件 安装 并 定期 更 新 。 














06... 基本 需求 是 满足 了 。 大 家 都 说 这 工具 用 着 不 错 ! 不 过 我 希望 的 是 更 定制 化 的 操作 ， 比 如 ， 单 独 测 试 菜 个 包 ， 或 者 直接 写 个 脚本 运行 ， 这 你 能 做 到 吗 ? 
Se 

CAAF, BOSSXdU ERT, "A? 

$6, ,. KRH, KREW! 只 需要 对 刚才 的 命令 稍 加 改进 即 可 ! 


加 上 选项 [option] 的 命令 如 下 : 





$ adb shell monkey [options] <event-count> 





Osz 3X 9 [options] € 44 monkey T 44 A 04 KA. 
SAB PAR 8d option di 4e AB Ay Ip HE VE? 


$9, iu 那 就 让 咱们 一 起 来 学 习 一 下 ! 


24 monkey 的 命令 及 其 使 用 
| C——— 主要 分 为 常规 类 、 事 件 类 、 约 束 类 和 调试 类 4 种 ， 下 面 分 别 进行 分 析 。 


24.1 monkey 的 常规 类 命令 























一 开始 ， 大 家 最 希望 知道 的 自然 是 monkey 都 有 哪些 命令 ， 这 些 命令 都 是 用 来 干什么 的 ， 每 个 命令 的 格式 是 什么 等 。 要 想 知道 这 些 帮助 信息 ， 还 有 什么 比 help 文 档 更 管用 的 ? 





$ adb shell monkey -h 





-h: 显示 monkey 参 数 帮 助 信息 usage， 运 行 结果 如 图 2-3 所 示 。 





C:\Documents and Settings\xubeni>adb shell monkey -h 

adb server is out of date. killing... 

* daemon started successfully * 

usage: monkey [-p ALLOWED_PACKAGE [-p ALLOWED_PACKAGE] ...1] 
[-c MAIN_CATEGORY [-c MAIN_CATEGORY] ...] 
[--ignore-crashes] [--ignore-timeouts] 
[--ignore-security-exceptions] 
[--monitor-native-crashesl [--ignore-native-crashes ] 
[--kill-process-after-errorl [--hprof ] 
[--pct-touch PERCENT] [--pct-motion PERCENT] 
[--pct-trackball PERCENT] [--pct-syskeys PERCENT ] 
[--pct-nau PERCENT] [--pct-majornau PERCENT ] 
[--pct-appsvitch PERCENT] [--pct-flip PERCENT] 
[--pct-anyeuvent PERCENT] [--pct-pinchzoom PERCENT ] 
[--pkg-blacklist-file PACKAGE BLACKLIST. FILE] 
[--pkg-vhitelist-file PACKAGE UHITELIST, FILE] 
[--vait-dbgl] [--dbg-no-events 1 
[--setup scriptfilel [-f scriptfile [-f scriptfilel ... 
[--port port] 
[-s SEED] [-v [-v] ...] 
[--throttle MILLISEC] [-—-randomize-throttle] 
[--profile-vait MILLISEC] 
[--deuvice-sleep-time MILLISEC] 
[--randomize-script ] 
[--script—log] 
[--bugreport 1 
[--periodic-bugreport ] 
COUNT 





图 2-3 ”monkey 参 数 帮助 信息 


fe 
全 So many! ! ! AMHR, 3170 4 4- RPI! 








这 些 常用 命令 稍 后 将 逐一 进行 分 析 。 




















在 一 般 情 况 下 ， 我 们 运行 程序 都 希望 能 看 到 运行 日 志 (俗称 log) ， 而 且 在 我 们 不 了 解 的 情况 下 ， 日 志 越 详细 越 好 。 





对 于 monkey 而 言 ， 只 需 在 monkey 命 令 后 跟 -v 参 数 即 可 打印 日 志 信息 。 





$ adb shell monkey -v «event-count» 

















ef 








-v: 打印 出 日 志 信息 ， 每 个 -v 将 增加 反馈 信息 的 级 别 。-v 越 多 日 志 信 息 越 详细 ， 不 过 目前 最 多 支持 3 个 -v， 即 : 


Sadb shell monkey -y -V -V 1000 BLE | 


0 级 ， 除 启动 提示 、 1 级 ， 提 供 较 详细 测 2 级 ,提供 更 详细 安装 
测试 完成 和 最 终结 试 信息 ， 如 逐个 发 信息 ， 如 测试 中 被 选中 









































果 外 提供 较 少 信息 送 到 Activity 的 事件 | | 或 未 被 选中 的 Activity 


5 
< 原来 每 增加 一 个 -v， 日 志 就 会 详细 很 多 ! 





monkey 常 规 类 命令 总 结 如 图 2-4 所 示 。 











| -h : monkey 参 数 帮助 信息 





0 级 ， 除 启动 提示 、 测 试 完成 
和 最 终结 果 外 提供 较 少 
一 一 “1 级 ， 提 供 较 详细 测试 信息 ， 
v: 打印 出 日 志 信 息 “如 逐个 发 送 到 Activity 
2 级 ， 提 供 更 详细 安装 信息 ， 
如 测试 中 被 选中 或 未 被 选中 的 Activity 


242 ”monkey 的 事件 类 命令 





事件 类 命令 可 以 对 随机 事件 进行 调控 ， 从 而 使 其 遵照 设 定 运 行 。 















































要 想 运行 monkey 脚 本 ， 首 先 要 学 会 -f 命 令 。 该 命令 后 面 可 接 monkey 测 试 脚本 ， 使 onkey 从 一 款 简 单 命令 行 工具 瞬间 变 为 强大 的 脚本 执行 工具 ， 如 : 





$ adb shell monkey -f <scriptfile> <event-count> 











-f: 后 接 测试 脚本 名 ， 表 示 要 使 用 monkey 运 行 指定 的 monkey 脚 本 ， 如 : 

















$ adb shell monkey -f /mnt/sdcard/test 1 





Qi 这 里 的 1 为 循环 次 数 而 非 事件 数 。 
具体 monkey 脚 本 编写 随后 将 详细 介绍 。 
< 从 味 ， 这 个 命令 可 以 满足 BOSS 通 过 脚本 控制 的 要 求 ! 


如 果 你 希望 重复 执行 之 前 的 随机 操作 ， 就 一 定 要 记 住 -s 命 令 ， 该 命令 可 指定 随机 数 生成 器 seed 值 («seed») . 








$ adb shell monkey -s «seed» <event-count> 





-s: 后 接 随 机 数 生 成 器 的 seed 值 。 

5 

<% 这 样 做 有 什么 好 处 呢 ? 

$9, s. 如 果 用 相同 的 secd 值 再 次 运行 monkey， 将 生成 相同 的 事件 序列 (也 就 是 说 ， 重 复 执行 刚才 的 随机 操作 ) 。 


人 区 随机 操作 都 能 重复 执行 ? 真是 一 个 超 强 的 命令 ! 
“-” 开 头 的 命令 说 完了 ， 接 下 来 说 “--” 开 头 的 命令 。 


如 果 你 希望 在 每 一 个 指令 之 间 加 上 国定 的 间隔 时 间 ,， 干 万 别 忘 了 用 --throttle (注意 ， 前 面 是 --) 命令 。 








$ adb shell monkey --throttle <milliseconds> 





--throttle: 后 面 接 时 间 ， 单 位 为 ms (<milliseconds>) ， 表 示 事 件 之 间 的 固定 延迟 ( 即 执行 每 一 个 指令 间隔 的 时 间 ) ， 若 不 接 该 选项 ，monkey 将 不 会 延迟 。 
< 全 必要 的 就 是 这 个 ， 动 作 之 间 有 延迟 才 来 得 及 响应 嘛 ! 


如 果 你 希望 调整 触摸 事件 的 百分比 ， 记 住 使 用 --ptc-touch。 











$ adb shell monkey --ptc-touch <percent> 





--ptc-touch: 后 面 接触 摸 事件 百分比 。 
CAAF EREN! 


QOO, e Eh xoi, 它 泛 指 发 生 在 菜 一 位 置 的 一 个 down-up 事 件 。 


如 果 你 希望 调整 动作 事件 的 百分比 ， 记 住 使 用 --ptc-motion。 





$ adb shell monkey --ptc-motion «percent» 





--ptc-motion: 后 面 接 动作 事件 百分比 。 


& 
Ronee, Addi 


Mo oieneceensoan, 它 泛 指 从 某 一 位 置 按 下 〈 即 down 事 件 ) 后 经 过 一 系列 伪 随 机 事件 后 弹 起 〈 即 up 事件 ) o 


动作 事件 百分比 命令 如 下 : 








$ adb shell monkey --ptc-trackball «percent» 





--ptc-trackball: 后 面 接轨 迹 球 事件 百分比 。 





CJUO 是 指 跟 随手 指 移动 的 光标 吗 ? 


二 yng 列 的 随机 移动 ， 以 及 偶尔 跟随 在 移动 后 面 的 点 击 事件 。 








如 果 你 希望 调整 基本 导航 事件 的 百分比 ， 记 住 使 用 --ptc-nav。 











$ adb shell monkey --ptc-nav «percent» 











--ptc-nav: 后 面 接 基本 导航 事件 百分比 。 














E 
人 《基本 导航 事件 主要 指 那 些 ? 


EE 方向 输入 设备 的 上 、 下 、 左 、 右 事件 。 

















来 自 方向 输入 设备 的 上 、 下 、 左 、 右 事件 ， 即 up、down、left、right 事 件 。 如 果 你 希望 调整 主要 导航 事件 的 百分比 ， 记 住 使 用 --ptc-majornav。 














$ adb shell monkey --ptc-majornav «percent» 





--ptc-majornav: 后 面 接 主要 导航 事件 百分比 。 


< 主要 导航 事件 和 基本 导航 事件 有 啥 不同 ? 


PC csuxnarnnamunan—ent, 如 5-way 键 盘 中 间接 键 、 返 回 按键 、 菜 单 按键 等 。 








如 果 你 希望 调整 系统 按键 事件 的 百分比 ， 记 住 使 用 --ptc-syskeys。 











$ adb shell monkey --ptc-syskeys «percent» 





--ptc-syskeys: 后 面 接 系统 按键 事件 百分比 。 


s» 
《系统 按键 和 普通 按键 有 哈 区 别 ? 


9o, 统 按键 事件 通常 指 仅 供 系 统 使 用 的 保留 按键 。 








仅 供 系统 使 用 的 保留 按键 ， 如 HOME 键 、BACK 键 、 拨 号 键 ( 即 Start Call) 



































如 果 你 希望 调整 应 用 启动 事件 的 百分比 ， 记 住 使 用 --pct-appswitch。 








、 挂 断 键 (End Call) RBH ( 即 Volume Controls) 等 。 





$ adb shell monkey --ptc-appswtich «percent» 














--ptc-appswitch: 后 面 接应 用 启动 事件 百分比 。 




















A& 哈 叫 应 用 启动 事件 ? 


eo 














如 果 你 希望 调整 其 他 类 型 事件 的 百分比 ， 记 住 使 用 --pct-anyevent。 





应 用 启动 事件 (Bpactivity launches) 俗称 打开 应 用 ， 通 过 调用 stattActivity0 方 法 最 大 限度 地 开启 该 package 下 的 所 有 应 用 。 





$ adb shell monkey --ptc-anyevent «percent» 








--ptc-anyevent: 后 面 接 其 他 类 型 事件 百分比 。 








全 % 哈 叫 其 他 类 型 事件 ? 


,EN 除 刚才 所 提 到 的 事件 外 的 所 有 事件 ， 如 keypress、 








s 
Sok, AET, GE FBOSSIZ ET re? | 


monkey 事 件 类 命令 总 结 如 图 2-5 所 示 。 





不 常用 的 button 等 。 


一 -f: 测试 脚本 名 运行 


o cs: 随机 运行 

一 一 -throttle : 指令 间 固 定时 间 间 隔 
--ptc-touch : 触摸 事件 百分比 
--ptc-motion : 动作 事件 百分比 
--ptc-trackball : 轨迹 球 事件 百分比 
--ptc-nav : 基本 导航 事件 百分比 

| _|--ptc-majornav : 主要 导航 事件 百分比 


RARA “| --ptc-syskeys : 系统 按键 事件 百分比 
--ptc-appswitch : 应 用 启动 事件 百分比 
keypress 
--ptc-anyevent : “不 常用 的 button 
其 他 类 型 事件 百分比 。” 其 他 未 提 及 事件 


图 2-5 ” monkey 事件 类 命令 总 结 





24.3 monkey 的 约束 类 命令 


约束 类 命令 可 以 让 你 将 随机 事件 运行 的 范围 牢 牢 限制 在 某 几 个 包 或 类 中 一 一 无 论 “ 悟 空 ” (monkey) 如 何 上 足下 跳 ， 也 逃 不 出 “如 来 佛 ” (限定 的 包 或 类 ) 的 手掌 心 。 


要 想 将 monkey 牢 牢 限制 在 某 个 或 某 几 个 包 中 ， 命 令 很 简单 。 





$ adb shell monkey -p «allowed-package-name» <event-count> 




















-p: 后 面 接 一 个 或 多 个 包 名 («allowed-package-name») ， 如 果 应 用 需要 访问 其 他 包 里 的 Activity， 那 相关 的 包 也 需要 在 此 同时 指定 。 如 果 不 指 定 任何 包 ，monkey 将 允许 系统 启动 全 部 包 里 的 
Activity。 每 个 -p 对 应 一 个 包 (指定 多 个 包 时 每 个 包 名 前 都 需要 加 上 -p) ， 如 : 








$ adb shell monkey -p com.xuben.test.settings 1000 





行 “com.xuben.test.settings” 包 内 Activity 并 发 送 1000 个 随机 事件 。 


[i 





Pe 


cob», ALA Sto HEA “HEE” (monkey) 也 能 被 关 在 “ 太 上 老 君 ”的 八卦 炉 里 。 


如 果 你 希望 将 monkey 限 制 在 一 个 或 几 个 类 别 中 ， 命 令 也 很 简单 : 





$ adb shell monkey -c <main-category> <event-count> 





-c: 后 面 接 一 个 或 多 个 类 别名 (BU«main-category» £3) ，monkey 将 只 人 允许 系统 启动 这 些 类 别 中 某 个 类 别 列 出 的 Activity。 


Osz ho RAIS ETT KH, monkey4Fit Intent. CATEGORY. LAUNCHERZv Intent. CATEGORY, monkey © 49 Activity. 


每 个 -c 对 应 一 个 类 别 (指定 多 个 类 别 时 每 个 类 别名 前 都 需要 加 上 -c) , 3n: 





$ adb shell monkey -c Intent.CATEGORY LAUNCHER 1000 





运行 Intent.CATEGORY_LAUNCHER 类 别 的 Activity 并 发 送 1000 个 随机 事件 。 


E 
<% 有 了 包 和 类 别 两 种 限制 方式 ， 以 后 配置 单独 的 测试 项 就 容易 多 了 。 


monkey 约 束 类 命令 总 结 如 图 2-6 所 示 。 





——* -p: 测试 一 个 或 多 个 包 © 





I 
eo 


测试 一 个 或 多 个 类 别 ， 





图 2-6 ”monkey 约 束 类 命令 总 结 


244 ”monkey 的 调试 类 命令 


通过 调试 类 命令 你 可 以 对 monkey 进 行 一 些 简单 的 调试 ， 这 样 可 以 快速 定位 monkey 运 行 中 的 问题 。 








如 果 你 希望 监视 应 用 程序 所 调用 的 包 之 间 的 转换 ， 那 一 定 会 用 到 --dbg-no-events 命 令 。 





$ adb shell monkey --dbg-no-events <event-count> 





--dbg-no-events: 在 设置 此 选项 后 ，monkey 将 进行 初始 启动 ， 进 入 到 某 个 测试 Activity 中 不 会 进一步 生成 事件 。 


O= 为 了 更 好 地 跟踪 ， 一 般 该 选项 会 与 -v (AA) 、-p<allowed-package-name> (65,25 &) 和 --throttle<milliseconds> (延迟 ) 等 联合 使 用 (延迟 至 少 308) ， 从 而 提供 一 个 可 监视 应 用 程序 所 调用 包 
之 间 转 换 的 环境 。 


哈哈， 有 了 这 个 调试 命令 ,就 可 以 轻松 打 入 运行 内 部 了 ! 





如 果 你 希望 在 事件 序列 前 后 立即 生成 profilfing report， 则 需要 用 到 --hprof 命 令 。 








$ adb shell monkey --hprof <event-count> 





--hprof: 在 设置 此 选项 后 ， 将 在 monkey 事 件 序列 前 后 立即 生成 profilfing report, 





Qi 该 选项 将 在 data/misc 中 生成 3MB 左 右 大 小 的 文件 ， 慎 用 ! 


人 KProfilfing report? 就 是 分 析 报 告 吧 ? 用 到 再 说 吧 ! 














如 果 你 希望 monkey 在 应 用 程序 崩 演 后 继续 发 送 事 件 ， 则 需要 用 到 --ignore-crashes 命 令 。 





























$ adb shell monkey --ignore-crashes «event-count» 





--ignore-crashes: 在 设置 此 选项 后 ， 当 应 用 程序 崩溃 或 发 生 失控 异常 时 ，monkey 将 继续 运行 直到 计数 完成 。 如 果 不 设置 此 选项 ，monkey 遇 到 上 述 骨 溃 或 异常 将 停止 运行 。 


全 % 这 选项 好 ， 老 焉 婆 肯 定 不 希望 晚上 自动 运行 时 一 出 状况 就 终止 。 




















如 果 你 希望 monkey 在 任何 超时 错误 发 生 后 继续 发 送 事 件 ， 则 需要 用 到 --ignore-timeouts 命 令 。 





$ adb shell monkey --ignore-timeouts <event-count> 














--ignore-timeouts: 在 设置 此 选项 后 ， 当 应 用 程序 发 生 任何 超时 错误 (如 ANP， 即 Application Not Responding) 时 ，monkey 将 继续 运行 直到 计数 完成 。 如 果 不 设置 此 选项 ，monkey 遇 到 此 类 超 
时 对 话 框 将 停止 运行 。 














fe 
人才 这 选项 也 不 错 ， 超 时 就 别 终止 了 ， 跑 得 正 欢 呢 ! 






































如 果 你 希望 monkey 在 应 用 程序 权限 错误 发 生 后 继续 发 送 事 件 ， 则 需要 用 到 --ignore-security-exceptions 命 令 。 





$ adb shell monkey --ignore-security-exceptions «event-count» 

















--ignore-security-exceptions: 在 设置 此 选项 后 ， 当 应 用 程序 发 生 任何 权限 错误 (如 启动 一 个 需要 某 些 权限 的 Activity) 时 ，monkey 将 继续 运行 直到 计数 完成 。 如 果 不 设置 此 选项 ，monkey 遇 到 此 类 
权限 错误 将 停止 运行 。 





全 % 权 限 是 个 大 问题 ， 不 过 即使 这 样 我 也 不 想 让 “悟空 ”(monkey) 停 下 来 。 






































如 果 你 希望 monkey 在 应 用 程序 出 错 后 通知 系统 停止 发 生 错 误 的 进程 ， 则 需要 用 到 --kill-process-after-error 命 令 。 





$ adb shell monkey --kill-process-after-error <event-count> 




















--kill-process-after-error: 在 设置 此 选项 后 ， 当 monkey 因 为 应 用 程序 发 生 错误 而 停止 时 ， 将 会 通知 系统 停止 发 生 错误 的 进程 。 如 果 不 设置 此 选项 ， 在 monkey 停 止 时 发 生 错误 的 应 用 程序 将 继续 处 于 


运行 状态 。 











-从 出 错 默认 就 该 通知 系统 清理 啊 ， 不 过 停留 在 出 错 界面 也 对 ， 保 留 犯罪 现场 。 


Qi monkey 正 常 结束 〈 即 成 功 运行 完成 ) 后 也 不 会 停止 启动 的 进程 ， 设 备 只 是 在 结束 事件 之 后 ， 简 单 地 保持 在 最 后 那个 状态 下 ， 而 不 会 回 到 主 界面 。 























如 果 你 希望 监视 并 报告 nonkey 运 行 时 Android 系 统 native code 的 崩溃 事件 ， 则 需要 用 到 --monitor-native-crashes 命 令 。 





$ adb shell monkey --monitor-native-crashes <event-count> 





--monitor-native-crashes: 在 设置 此 选项 后 ，monkey 运 行 时 native code 的 骨 溃 事件 将 被 监视 并 报告 。 如 果 不 设置 此 选项 ， 将 不 会 监视 此 类 事件 。 
Qa 如 果 此 时 还 设置 了 --kill-process-after-etror 命 令 ， 此 类 前 溃 (system native code) 系统 也 将 停止 运行 。 


< 全 必 刚 才 有 个 程序 员 还 问 我 能 不 能 抓 一 下 nativecode 的 崩溃 ， 这 下 有 办 法 了 。 




















如 果 你 希望 在 调试 器 连接 前 暂停 执行 中 的 monkey， 则 需要 用 到 --wait-dbg 命 令 。 








$ adb shell monkey --wait-dbg «event-count» 





--wait-dbg: 在 设置 此 选项 后 ， 将 暂停 执行 中 的 monkey， 直 到 有 调试 器 与 它 连接 。 








monkey 调 试 类 命令 总 结 如 图 2-7 所 示 。 











* --dbg-no-events : 监视 应 用 程序 所 调用 的 包 之 间 的 转换 ， 


_—4 | --hprof : 在 事件 序列 前 后 立即 生成 profiling report 


--ignore-crashes : 
在 应 用 程序 崩溃 后 继续 发 送 事件 
— |- --ignore-timeouts : 
出 错 后 继续 发 送 事件 “ 在 任何 超时 错误 发 生 后 继续 发 送 事件 


--ignore-security-exceptions : 


在 应 用 程序 权限 错误 发 生 后 继续 发 送 事件 








— . ^ --kill-process-after-error : 


在 应 用 程序 出 错 后 通知 系统 停止 发 生 错 误 的 进程 


— . --monitor-native-crashes : 


l 监视 并 报告 nonkey 运 行 时 Android 系 统 native code 的 骨 溃 事件 


~ --wait-dbg : 暂停 执行 中 的 monkey ,直到 有 调试 器 与 它 连接 ， 


图 2-7 monkey 调 试 类 命令 总 结 


24.5 ”monkey 命 令 小 结 














当然 ， 常 用 参数 远 不 止 这 几 条 ，monkey 常 用 参数 参见 官网 : http://developer.android.com/tools/help/monkey.html。 


























不 过 ,在 了 解 这 几 个 参数 后 ， 我 们 不 难 读 懂 : 





Sadb shell monkey-v -v -v -p com.xuben.test --throttle 5000 1000 


2 级 日 志 ， 提 供 更 详细 
的 安装 信息 ， 如 测试 {X 测试 com.xuben. 每 个 指令 之 1000 个 随机 


中 被 选中 或 未 被 选中 的 test 这 个 包 JAER 5 Pb 事件 
Activity 





fe 
他 % 哇 ， 看 似 复 杂 的 指令 一 下 子 变 得 异常 简单 ! 


我 们 也 不 难 写 出 : 
$adb shell monkey-v -v -f /mnt/sdcard/test --throttle 200 30 






14 43 AS 36 A 
运行 /mnt/sdcard/ 每 个 指令 之 重复 运行 该 


1 级 日 志 ， 提 供 较 详细 
的 测试 信息 ， 如 逐个 发 
送 到 Activity 的 事件 






路 径 下 名 为 test lia] 4E 38 200 : 
脚本 30 次 
的 脚本 






monkey 监 控 并 特殊 处 理 的 3 个 事件 如 下 。 


1) 如 果 指 定 测试 包 ， 限 制 测试 在 指定 的 包 中 。 








2) 如 果 应 用 crash 或 存在 未 捕获 的 异常 ，monkey 停 止 并 报告 错误 。 
产生 ANR (Application Not Responding) 错误 ，monkey 停 止 并 报告 错误 。 产 生 ANR 的 两 个 条 件 如 下 。 




















3) 如 果 应 
“ 线程 响应 超过 5s。 


+ HandleMessage ©) 39] $ 228 3310s 


对 monkey 命 令 的 学 习 到 此 告 一 段落 ， 接 下 来 ， 我 们 将 从 对 monkey 的 API 分 析 中 一 步 步 学 习 monkey 脚 本 的 编写 ， 并 通过 对 另外 两 个 实用 























命令 getevent 和 Input keyevent 的 原理 的 简单 分 析 ， 让 大 家 直 





观感 受 Android 的 keyevent 的 魅力 。 


fe 
人 哈哈， 现在 BOSS 的 要 求 完全 不 是 问题 了 ， 下 一 步 就 该 学 学 脚本 了 。 


e 


25 第 二 个 Impossible Mission 


Orare, 基本 要 求 都 实现 了 ! 


不 过 我 听 测 试 员 说 monkey 只 会 乱 点 ， 没 办 法 替代 黑金 用 例 ， 能 不 能 想 个 办 法 做 些 简 单 的 自动 化 的 工作 ? 











2-8 所 示 ) ， 你 们 能 通过 monkey 做 到 自动 填写 、 选 择 和 提交 吗 ? 

















比如 ， 下 面 这 个 Bugben 应 用 (如 图 





CG? oe.) COG) 18:26 


王 下 框 中 输入 希望 修改 的 文字 : 
文本 框 1 文字 : 


二 选择 文字 属性 
TBE LEASH A、 y 
MES O) (S) unm 


文本 框 2 大 小 : 


Orr 





图 2-8 Bugben 应 用 界面 
im 
-人 发 奔 可 ，BOSS 真 是 得 寸 进 尺 ， 自 动 化 任务 monkey 哪 能 做 得 了 ? 
eo... 用 她 的 话说 : 有 条 件 的 要 上 ， 没 有 条 件 的 创造 条 件 也 要 上 1! 
im 
全 怎么 创造 ? monkey 本 来 就 是 发 送 随 机 事件 的 工具 ， 如 果 有 规律 就 不 叫 monkey 了。 
eo... 你 还 记得 monkey 主 要 发 送 哪 些 随机 事件 吗 ? 
Ss 
全 当然 记得 ， 点 击 、 输 入 和 手势 3 种 。 


so, 那 咱们 就 以 这 3 种 事件 为 入 口 学 习 一 下 MONKEY 脚 本 编写 吧 ! 


2.6.14 monkey APl 详 解 


| antasts, 即 传 说 中 的 轨迹 球 事件 。 


1 轨迹 球 事件 





DispatchTrackball (long downTime, long eventTime, int action, 
float x, float y, float pressure, float size, int metaState, 
float xPrecision, float yPrecision, int device, int edgeFlags) 





fe 
SK, RAZR, TEASA! 


Oz 大 家 不 要 被 这 么 多 参数 吓 坏 ， 其 实 我 们 最 关注 的 ， 只 有 action、x、y 这 3 个 而 已 。 





对 于 action， 我 们 只 需要 简单 了 解 0 代表 按 下 (KeyDown) ，1 代 表 弹 起 (KeyUp) 即 可 。 由 此 可 知 ， 如 果 要 实现 点 击 事件 ， 该 方法 应 该 成 对 出 现 ， 并 且 action 参 数 应 该 先 传 入 0， 然 后 传 入 1， 例 如 : 








DispatchTrackball (5109520, 5109520, 0, 1150, 330, 0, 0, 0, 0, 0, 
DispatchTrackball (5109520, 5109520, 1, 1150, 330, 0, 0, 0, 0, 0, 0, 0) 





而 对 于 x 和 y， 相 信 大 家 已 经 猜 到 ， 没 错 ， 就 是 定位 的 坐标 点 。 例 如 ， 此 处 的 〈1150，330) 即 为 该 坐标 点 。 
参数 详细 说 明 如 下 。 

‘long downtime， 键 最 初 被 按 下 的 时 间 。 

“ long eventTime， 事 件 发 生 的 时 间 。 

' int action， 动 作 : ACTION_DOWN=0, ACTION UP-1, ACTION_MULTIPLE=2。 

+ float x，x 坐 标 。 

- float y，y 坐 标 。 

- float pressure， 当 前 事件 的 压力 ， 范 围 0~1。 

+ float size， 触 摸 的 近似 值 ， 范 围 0~1。 

- int metaState， 当 前 按 下 的 meta 键 的 标识 。 


+ float xPrecision ，x 坐 标 精确 值 。 





* float yPrecision, ，y 坐 标 精确 值 。 
“ int device， 事 件 来 源 ， 范 围 0~x，0 表 示 不 来 自 物理 设备 。 
+ int edgeFlags， 坐 标 是 否 超出 了 屏幕 范围 。 


接 下 来 看 输入 ， 即 输入 字符 串 事 件 。 





2. 输 入 字符 串 事 件 








DispatchString (String text) 





Oez 输入 一 个 不 加 引号 的 字符 串 ， 如 Dispatchstting(abcd) ， 表 示 输 入 adbc 字 符 。 





全 哈哈 ， 这 个 简单 ， 想 输入 什么 就 填 什么 ! 
再 接 下 来 是 点 击 ， 即 点 击 事件 。 


3. 点 击 事件 





DispatchPointer (long downTime, long eventTime, int action, float x, float y, float pressure, float size, int metaState, float xPrecision, float yPrecision, int device, int edge 





So 

LIER AERA FAIR? | 

Oz 与 轨迹 球 (DispatchTrackball) 类 似 ， 该 方法 也 只 需 关 注 action、x、y 即 可 ， 具 体 解释 与 参数 详细 说 明 参 见 DispatchTrackball。 
SF, RRA RHA! 

1) 如 果 我 希望 直接 启动 某 个 应 用 测试 该 怎么 办 ? 

2) 如 果 操 作 后 程序 反应 不 过 来 又 该 怎么 办 ? 

3) 如 果菜 个 操作 总 是 无 效 还 有 其 他 方法 吗 ? 

qo... 你 问题 还 真 不 少 ! 


1) 我 们 需要 启动 应 用 事件 来 直接 启动 应 用 。 


2) 我 们 需要 等 待 事件 来 等 待 程序 反应 。 


3) 我 们 可 以 通过 键 值 事 件 直接 发 送 键 值 进行 操作 。 








4 .启动 应 用 











LaunchActivity (String pkg name, String cl name) 





人 哈哈， 通过 这 种 方式 启动 应 用 的 确 方便 ! 


Guz 参数 为 应 用 所 在 包 名 (pkg_name) 和 应 用 名 (cl name) , de: 





LaunchActivity (com.android.browser, com.android.browser.BrowserActivity) 





这 样 就 可 以 启动 浏览 器 (BrowserActivity) 这 个 应 用 了 。 


5 等 待 事件 





UserWait(long sleeptime) 





Ck, EARL, PER RAEN? 


3 


毫秒 吧 ? 你 确认 一 下 ! 
er 操作 需要 等 待 的 时 间 ， 单 位 为 毫秒 ， 如 UserWait(3000) 表 示 等 待 3 秒 。 


6. 按 下 键 值 





DispatchPress (int keyCode) 





LÀ 
CRT? 这 些 键 值 在 哪 能 查 到 ? 


Oez 常用 的 keycode 参 见 附 录 A， 具 体 可 参见 android.view KeyEvent.java。 当 然 ， 如 果 你 认为 不 够 ， 还 可 以 为 Android 添 加 新 键 值 ， 网 上 有 很 多 资料 ， 这 里 不 详 述 。 


7 长 按键 值 





LongPress (int keyCode) 





ie 
Ck? 为 何 短 操 作 CEE) 按 这 么 多 参数 ， 长 按 操作 一 个 参数 就 够 了 ? 我 还 是 喜欢 简单 的 …… 
Giz 与 按键 事件 一 样 ， 不 过 这 次 是 对 键 值 进 行 长 按 操作 。 


8. 发 送 键 值 





DispatchKey (long downTime, long eventTime, int action, int code, int repeat, 
int metaState, int device, int scancode) 





E 
-人 发送 键 值 的 确 比 简单 地 按 下 键 值 复杂 得 多 。 


eo 与 轨迹 球 类 似 ， 该 方法 也 只 需 关 注 action 和 code 即 可 。 

参数 详细 说 明 如 下 。 

"long downTime， 键 最 初 被 按 下 的 时 间 。 

' longeventTime， 事 件 发 生 的 时 间 。 

+ int action， 动 作 : ACTION_DOWN=0，ACTION_UP=1，ACTION_MULTIPLE=2。 
‘int code， 键 值 ， 参 见 附录 A。 

-int repeat， 重 复 次 数 。 

+ int metaState， 当 前 按 下 的 meta 键 的 标识 。 

“ int device， 事 件 发 生 的 设备 id。 


“int scancode， 上 报 点 的 信息 。 


9. 开 关 软 键盘 





DispatchFlip (boolean keyboardOpen) 





人 这 个 有 意思 ， 传 入 布尔 值 ? 


26, ,, 表示 是 否 打开 软 键盘 ，true 表 示 打 开 ，false 表 示 关 闭 。 


2.6.2 monkey 脚本 编写 











了 解 了 monkey 常 用 API， 让 我 们 来 熟悉 一 人 monkey 脚 本 的 编写 规范 。 












































monkey script 是 按照 一 定 的 语法 规则 编写 有 序 的 用 户 事件 流 ， 并 适用 于 monkey 命 令 工具 的 脚本 。 相 信 很 多 朋友 同 巴 哥 奔 一 样 是 从 monkeySourceScriptjava 源 码 注释 中 寻找 到 如 下 使 用 monkey 
script 编 写 的 线索 的 ， 如 代码 清单 2-2 所 示 。 























代码 清单 2-2 monkeySourceScript.java 脚 本 注释 





/** 
* monkey event queue. It takes a script to produce events sample script format: 


<pre> 
type= raw events 

count= 10 

speed= 1.0 

start data >> 

captureDispatchPointer (5109520, 5109520, 0,230.75429, 458.1814, 

0.20784314, 0.06666667,0,0.0,0.0, 65539, 0) 

captureDispatchKey (5113146, 5113146, 0,20,0,0,0,0) 

captureDispatchF lip (true) 

http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15501/OEBPS/Text/... 
</pre> 


HOt Ok RO E E 


~ 





从 代码 清单 2-2 中 可 以 看 出 ，monkey script 的 编写 一 般 以 如 下 4 条 语句 开头 。 





type = raw events 


count = 10 type: 指明 脚本 类 型 ， 
speed = 1.0 - 般 不 用 更 改 


start data >> 


speed : 命令 执行 速率 ， 
巴 哥 奔 发 现 这 里 改动 无 





影响 ， 速 率 也 可 通过 
monkey 命令 行 指定 





start data>> 相当 于 一 个 count : 脚本 执行 次 数 ， 但 是 巴 哥 奔 发 现 将 
说 明 脚 本 从 下 面 这 里 改 成 任何 值 都 只 执行 一 次 ，monkey fit 


die J 令 可 以 指定 执行 次 数 ， 所 以 这 里 也 不 用 更 改 





全 XBOSS， 你 想 要 什么 ? 


Oraa, 先 随便 输入 、 选 择 、 提 交 ， 我 看 看 效果 。 











了 解 monkey 常 用 API 后 ， 我 们 可 以 尝试 写 一 个 简单 脚本 。 比 如 ， 我 们 希望 进行 如 下 操作 。 




















1) 打开 Bugben 应 用 。 











2) 在 文本 框 1 中 输入 数字 111， 在 文本 框 2 中 输入 字母 aaa。 
3) 点 击 提交 。 
这 个 脚本 该 如 何 写 呢 ? 


首先 ， 我 们 把 开头 4 行 原 样 写 上 ， 如 代码 清单 2-3 所 示 。 





代码 清单 2-3 ”monkey 示 例 脚本 前 4 行 





# Start Script 
type = user 
count = 10 
speed = 1.0 
start data >> 









































接 下 来 开始 写 脚本 正文 ， 要 启动 Bugben 应 用 需要 调用 应 用 启动 接口 ， 而 该 接口 需要 传 入 两 个 参数 : 待 启动 应 用 的 包 名 和 应 用 名 。 























E 
全 5 我 如 何 才能 知道 包 名 和 应 用 名 呢 ? 














1) 查看 包 名 : 进入 $adb shell 后 通过 #ls data/data 可 查看 所 有 应 用 的 包 名 ， 如 图 2-9 所 示 。 








$ adb shell 
# 1s data/data 





D: \xuben \android-sdk-windows4.2\tools>adb shell 
root@android:/ # ls data/data 

ls data/data 

com.IdeaFriendSecreteCode 
com.android.backupconfirm 

com.android.bluetooth 

com.android.browser 


com.android.calculator2 
com.android.cellbroadcastreceiver 
com.android.certinstaller 
com.android.defcontainer 
com.android.dolbymobileaudioeffect 
com.android.galaxy4 
com.android.gallery3d 


om.xuben.hellobugben 


图 2-9 查看 应 用 包 名 











发 现 Bugben 应 用 的 包 名 为 “com.xuben.hellobugben”。 



































到 2-10 所 示 。 





2) 查看 应 用 ( 主 界面 ) 名 : 通过 logcat|busybox grep START 可 查看 应 用 名 (确切 地 说 是 应 用 主 界面 名 ) , 4 




















£2 












































$ adb shell 
# logcat | busybox grep START 


I/ActivityManager( 1238): START u@ <act=android.intent.action.MAIN cat=Landroid. 
intent .category.LAUNCHER] flg=0x10200000 cmp=com.xuben.hellobugbhen/’.Changefctivi 


ty bnds=(323,10121[495,11841> from pid 1760 








图 2-10 ”查看 应 用 名 






































从 “cmp=com.xuben.hellobugben/.ChangeActivity” 这 句 可 以 看 出 Bugben 的 应 用 主 界面 名 为 “ChangeActivity”。 








由 此 ,我 们 知道 如 何 启动 Bugben 应 用 : 

















LaunchActivity (com.xuben.hellobugben, com.xuben.hellobugben.ChangeActivity) 











启动 完 Bugben 应 用 ， 我 们 需要 对 文本 框 1 和 文本 框 2 进行 输入 。 输 入 操作 听 上 去 很 简单 ， 但 其 实 包括 了 如 下 步骤 。 




















1) 选中 文本 框 : 通过 点 击 文本 框 事件 进行 选中 ， 其 中 点 击 事件 又 分 两 种 ， 如 下 : 














. 按 下 事件 。 
. 弹 起 事件 。 


如 代码 清单 2-4 所 示 。 





代码 清单 2-4 ”选中 文本 框 





# 点 击 文本 框 1 
captureDispatchPointer (10, 10, 0, 327, 231, 1, 1, -1, 1, 1, 0, 0) 
captureDispatchPointer (10, 10, 1, 327, 231, 1, 1, -1, 1, 1, 0, 0) 


Oez 具体 坐标 查看 可 进入 $adb shell 后 通过 getevent 命 令 进 行 ， 当 然 ， 该 坐标 需要 进行 进 制 转换 和 分 辨 率 调 整 。 











2) 确定 输入 内 容 : 通过 输入 字符 串 事件 进行 文本 输入 ， 如 代码 清单 2-5 所 示 。 














代码 清单 2-5 ”确定 输入 内 容 


# 确定 文本 框 1 内 容 
captureDispatchString (111) 
+ 发 送 Enter 键 使 输入 内 容 从 软 键盘 到 文本 框 中 


captureDispatchPress ( 66) 


Grex Enter 键 对 应 键 值 : KEYCODE_ENTER=66， 参 见 附录 A。 
3) 对 于 文本 框 2 的 输入 也 是 如 此 ， 如 代码 清单 2-6 所 示 。 


代码 清单 2-6 输入 文本 框 2 的 内 容 





+ 点 击 文本 框 2 
captureDispatchPointer (10, 10, 0, 327, 375, 1, 1, -1, 1, 1, 0, 0) 
captureDispatchPointer (10, 10, 1, 327, 375, 1, 1, -1, 1, 1, 0, 0) 
# 输入 文本 框 2 内 容 

captureDispatchString (aaa) 

* 发 送 Enter 键 使 输入 内 容 从 软 键盘 到 输入 框 中 

captureDispatchPress (66) 








4) 接 下 来 ， 点 击 单 选 框 ， 这 个 直接 点 击 即 可 ， 如 代码 清单 2-7 所 示 。 


代码 清单 2-7 ”点 击 单 选 框 





# 选择 文本 框 1 为 不 加 粗 


captureDispatchPointer(10, 10, 0, 500, 600, 1, 1, -1, 1, 1, 0, 0) 
captureDispatchPointer(10, 10, 1, 500, 600, 1, 1, -1, 1, 1, 0, 0) 
# 选择 文本 框 2 为 小 号 

captureDispatchPointer(10, 10, 0, 327, 744, 1, 1, -1, 1, 1, 0, 0) 
captureDispatchPointer(10, 10, 1, 327, 744, 1, 1, -1, 1, 1, 0, 0) 





5) 再 等 待 500 毫 秒 确保 输入 、 选 择 操作 完毕 后 再 进行 提交 ， 如 代码 清单 2-8 所 示 。 


代码 清单 2-8 等 待 500 毫 秒 





# 等 待 500 毫 秒 
UserWait (500) 





6) 最 后 ， 点 击 提交 按钮 进行 提交 ， 如 代码 清单 2-9 所 示 。 


代码 清单 2-9 ”点 击 提交 





# 点 击 提交 
captureDispatchPointer(10, 10, 0, 555, 999, 1, 1, -1, 1, 1, 0, 0) 
captureDispatchPointer(10, 10, 1, 555, 999, 1, 1, -1, 1, 1, 0, 0) 





完整 脚本 如 代码 清单 2-10 所 示 。 


代码 清单 2-10 ”完整 脚本 





# Start Script 

type - user 

count - 10 

speed - 1.0 

start data >> 

LaunchActivity (com. xuben.hellobugben, com. xuben.hellobugben.ChangeActivity) 
UserWait (5000) 

# 点 击 文本 框 1 

captureDispatchPointer(10, 10, 0, 327, 231, 1, 1, -1, 1, 1, 0, 0) 
captureDispatchPointer(10, 10, 1, 327, 231, 1, 1, -1, 1 0, 0) 
+ 输入 文本 框 1 内 容 

captureDispatchString (111) 

+ 发 送 Enter 键 使 输入 内 容 从 软 键盘 到 输入 框 中 
captureDispatchPress (66) 

# 点 击 文本 框 2 

captureDispatchPointer (10, 10, 0, 327, 375, 1, 1, -1, 1, 1, 0, 0) 
captureDispatchPointer(10, 10, 1, 327, 375, 1, 1, -1, 1 0 

# 输入 文本 框 2 内 容 

captureDispatchString (aaa) 

+ 发 送 Enter 键 使 输入 内 容 从 软 键盘 到 输入 框 中 

captureDispatchPress (66) 

# 选择 文本 框 1 为 不 加 粗 





captureDispatchPointer(10, 10, 0, 500, 600, 1, 1, -1, 1, 1, 0, 0) 
captureDispatchPointer(10, 10, 1, 500, 600, 1, 1, -1, 1, 1, 0, 0) 
# 选择 文本 框 2 为 小 号 

captureDispatchPointer(10, 10, 0, 327, 744, 1, 1, -1, 1, 1, 0, 0) 
captureDispatchPointer(10, 10, 1, 327, 744, 1, 1, -1, 1, 1, 0, 0) 
+ 等 待 500 毫 秒 

UserWait (500) 

# 点 击 提交 

captureDispatchPointer(10, 10, 0, 555, 999, 1, 1, -1, 1, 1, 0, 0) 
captureDispatchPointer(10, 10, 1, 555, 999, 1, 1, -1, 1, 1, 0, 0) 





将 上 述 代码 另存 为 Input_bugben 文 件 。 

5 

Ck? PIE LH, AA ERED? ARABAT? 

, | PT 

Qi monkey 脚 本 没有 文件 格式 限制 ， 所 以 无 论 保存 为 .txt 还 是 其 他 格式 都 可 以 正常 运行 


将 该 脚本 文件 复制 到 手机 里 或 运行 命令 : 


， 巴 哥 奔 习 惯 不 加 任何 后 缓和 名， 以 示 区 分 。 





$ adb push input bugben /mnt/sdcard/ 





然后 运行 : 





$ adb shell monkey -v -f /mnt/sdcard/input bugben 10 





脚本 后 跟 数字 10 表 示 运 行 该 脚本 10 遍 。 结 果 显 示 如 下 。 














1) 进入 Bugben 应 用 。 




















EM 














bugben 
请 在 下 框 中 输入 希望 修改 的 文字 : 


E111 























j 
| 


文本 框 2 文字 : aaa 


请 选择 文字 属性 : 
Or Ons: 


文本 框 1 粗细 : 


un = ES T ao Vv | 
a[w|e||v]v]v] Jo] 
HHBBHHHHB 











^ 


哈哈， 杭 定 收工 ! 不 过 对 于 坐标 的 获取 和 转换 ， 我 还 想 更 深入 地 了 解 一 下 。 


[Dae 

















上 节 提 到 ，monkey 脚 本 的 核心 是 要 准确 地 获取 坐标 以 提供 点 击 。 前 面 提 到 通过 getevent 方 法 获取 坐标 ， 在 解释 monkey 原 理 前 ， 先 跟 大 家 聊 聊 getevent 和 sendevent 一 一 这 种 最 最 基本 的 通过 坐标 操 
作 控 件 的 方式 或 许 会 给 大 家 一 些 启发 。 





























getevent 和 sendevent 是 Android 系 统 下 的 一 个 工具 ， 可 以 模拟 多 种 按键 和 触 屏 操 作 ， 产 生 的 是 raw event, raw event 经 过 event hub 处 理 产 生 最 终 的 gesture 事 








F 











在 命令 行 上 输入 : 


$ adb shell getevent 





即 可 看 到 命令 行动 态 打印 出 如 下 结果 ， 如 图 2-13 所 示 。 











c\ far S 1e -adb shell 


/dev/input/eventi: 000000c8 
/dev/input/eventi: 660608065 
/dev/input/eventi: 66600169 
/dev/input/eventi: 6660046c 
/dev/input/eventi: 090000000 
/dev/input/eventi: 08008008 


/dev/input/eventi: 000000c8 
/dev/input/eventi: 08088085 
/dev/input/eventi: 00000169 
/dev/input/eventi: 6660046c 
/dev/input/eventi: 080000800 
/dev/input/eventi: 00000000 





图 2-13 ”getecent 运 行 结 果 显示 
Se 
全 5 这 几 个 东西 分 别 是 哈 意 思 ? 
在 源码 “kernel/include/linux/Input.h” 中 可 以 查看 type、code、value 的 定义 。 
我 们 发 现 type、code、value 是 互相 影响 的 ， 先 找到 type 的 定义 ， 如 代码 清单 2-11 所 示 。 


代码 清单 2-11 Input.h 中 type 定 义 





/* 

* Event types 

x 

# define EV SYN 0x00 
# define EV_KEY 0x01 
# define EV REL 0x02 
# define EV ABS 0x03 
# define EV MSC 0x04 
# define EV_SW 0x05 
* define EV LED 0x11 
# define EV SND 0x12 
# define EV REP 0x14 
# define EV f 0x15 
# defi. V PW 0x16 
# define EV f STATUS 0x17 
# defi. ^ MA Oxlf 
* define EV CNT (EV MAX*1) 





从 代码 清单 2-11 中 不 难 发 现 ， 命 令 中 0000~0003 分 别 代表 EV_SYN (同步 事件 ) . EV KEY (keyboard) , EV REL (相对 坐标 ) 和 EV_ABS (绝对 坐标 ) 。 这 里 出 现 的 0000 (EV SYN) 表示 一 组 完整 
事件 已 经 完成 ，EV_SYN 的 code 定 义 事件 分 发 的 类 型 ， 如 代码 清单 2-12 所 示 。 











代码 清单 2-12 ”EV_SYN 的 code 定 义 事件 分 发 类 型 





ne SYN REPORT 0 
ne SYN CONFIG 1 
ne SYN MT REPORT 2 











对 于 同步 事件 0000 (EV SYN) ， 我 们 了 解 这 些 就 足够 了 。 我 们 再 来 看 看 type 为 0003 时 的 code， 此 时 code 分 别 为 0030、0032、0035 和 0036， 这 又 是 什么 意思 呢 ? 


我 们 在 源码 “kernel/include/linux/Input.h” 中 找到 ， 如 代码 清单 2-13 所 示 。 


代码 清单 2-13 Input.h 中 code 定 义 


* 


* Absolute axes 
/ 


define ABS X 0x00 
define ABS Y 0x01 


define ABS RX 0x03 

define ABS RY 0x04 

define ABS RZ 0x05 

define ABS THROTTLE 0x06 

define ABS RUDDER 0x07 

define ABS WHEEL 0x08 

define ABS GAS 0x09 

define ABS BRAKE Ox0a 

define ABS HATOX 0x10 

define ABS HATOY 0x11 

define ABS_HAT1X 0x12 

define ABS HAT1Y 0x13 

define ABS HAT2X Ox14 

define ABS HAT2Y 0x15 

define ABS HAT3X Ox16 

define ABS HAT3Y 0x17 

define ABS PRESSURE 0x18 

define ABS DISTANCE 0x19 

define ABS TILT X Oxla 

define ABS TILT Y Oxlb 

define ABS TOOL WIDTH Oxlc 

define ABS VOLUME 0x20 

define ABS MISC 0x28 

define ABS MT TOUCH MAJOR 0x30 /* Major axis of touching ellipse */ 
define ABS MT TOUCH MINOR 0x31 /* Minor axis(omit if circular) */ 
define ABS MT WIDTH MAJOR 0x32 /* Major axis of approaching ellipse */ 
define ABS MT WIDTH MINOR 0x33 /* Minor axis(omit if circular) */ 
define ABS MT ORIENTATION 0x34 /* Ellipse orientation */ 

define ABS MT POSITION X 0x35 /* Center X ellipse position */ 
define ABS MT POSITION Y 0x36 /* Center Y ellipse position */ 
define ABS MT TOOL TYPE 0x37 /* Type of touching device */ 
define ABS MT BLOB ID 0x38 /* Group a set of packets as a blob */ 
define ABS MT TRACKING ID 0x39 /* Unique ID of initiated contact */ 
define ABS MT PRESSURE Ox3a /* Pressure on contact area */ 
define ABS MAX Ox3f 

define ABS CNT (ABS_MAX+1) 


JE SE SE JE HE dedb de db db de dE db de db db dE dE dE dE dE dE dE db db dE db dE dE db de de dE db dE d db db E 
* 


不 难 发 现 ，0000~0002 分 别 代表 绝对 坐标 X、Y 和 Z。 





- 0030: 主 接触 面 的 长 轴 (BS MT TOUCH. MAJOR) ， 它 和 X，Y 同 一 个 单位 ， 如 果 一 个 面 的 分 辨 率 为 X*Y， 则 ABS_MT TOUCH_MAJOR 的 最 大 值 为 sqrt (X*2+Y%2) 。 























- 0032: 接触 工具 的 长 轴 (ABS MT WIDTH MAJOR) 。 











- 0035: 椭圆 中 心 绝对 坐标 X (ABS MT POSITION X) 。 














- 0036: 椭圆 中 心 绝对 坐标 Y (ABS MT POSITION Y) 。 








如 此 ， 我 们 知道 ， 当 0030 和 0032 出 现时 ， 表 示 有 触 屏 事件 发 生 ， 而 0035 和 0036 出 现 则 代表 实际 触 屏 时 的 绝对 坐标 X 和 Y (比如 这 里 的 169 和 46c) 。 

















之 前 提 到 ， 通 过 getevent 捕 获 到 的 这 个 坐标 点 (169, 46c) 是 value 为 16 进 制 当前 设备 分 辨 率 下 的 坐标 值 ， 由 此 可 知 ，10 进 制 的 坐标 点 应 该 为 (361，1132) 。 当 我 们 更 换 为 不 同 分 辨 率 的 手机 时 (如 
分 辨 率 变 为 800x480) ， 很 明显 两 个 点 是 完全 不 匹配 的 ， 那 如 何 转换 呢 ? 








我 们 可 以 通过 如 下 命令 : 


$ adb shell getevent -p 








找到 当前 设备 ， 如 getevent 显 示 device name 为 “/dev/Input/event1”， 对 应 的 设备 号 就 是 add device 4， 找 到 当前 设备 后 信息 如 图 2-14 所 示 。 











dd device 4: /dev/input/event1 
name: "ft5xDBx ts" 
events: 

ABS «0003»: 0030 value i 255, fuzz Ø. flat Ø. resolution @ 
value 200. fuzz Ø., flat Ə. resolution @ 
value 720. fuzz Ø. flat Ø. resolution @ 
value 1286, fuzz Ø, flat 0, resolution @ 


input props: 
<none> 





图 2-14 ”当前 设备 信息 








这 里 显示 了 code 的 范围 ， 我 们 发 现 code 为 0035 和 0036 的 对 应 本 机 x 的 值 min 为 0，max 为 720; y 的 值 min 为 0，max 为 1280。 
































这 样 就 找到 你 的 设备 的 坐标 具体 值 ， 通 过 Android VNC Server 源 码 ， 可 反 向 推出 如 下 计算 公式 (同一 款 设备 无 需 分 辩 率 转换 ) 。 








-X= (x-xmin) x (getevent 十 进 制 值 x 设 备 的 分 辨 率 宽度 ) / ([D035max]-[0035min]) . 


“Y= (y-ymin) x (getevent 十 进 制 值 x 设 备 的 分 辨 率 高 度 ) / ([0036max]-[0036min]) 。 











这 样 ， 算 出 的 坐标 值 就 跟 你 手机 的 屏幕 分 辨 率 相 匹配 了 。 











Qi 该 公式 适用 于 目前 手机 min 都 为 0 的 情况 ， 未 测试 过 不 为 0 的 情况 ， 如 果 不 为 0， 需 要 大 家 重新 验证 此 公式 正确 性 ， 欢 迎 指正 。 


在 清楚 getevent 坐 标 值 换算 后 ， 即 可 传 入 monkey 脚 本 进行 运行 。 














对 于 Input keyevent， 在 了 解 常用 键 值 表 (参加 附录 A) 之 后 ， 我 们 其 实 已 经 掌握 了 一 种 最 为 简单 的 模拟 按键 方式 。 


$ adb shell input keyevent [key value] 





比如 ， 我 们 查 到 Menu 菜 单 的 键 值 为 82， 只 需 发 送 如 下 命令 : 





$ adb shell input keyevent 82 





即 可 实现 菜单 点 选 ， 非 常 方便 。 








对 于 monkey 的 初学 者 而 言 ， 了 解 到 这 里 就 足够 在 工作 中 应 用 了 。 至 于 monkey 的 实现 原理 及 底层 技术 ， 稍 后 原理 篇 中 将 进行 详 述 。 














哈哈， 总 算 清楚 了 ， 学 得 好 累 啊 ! 休息 ， 休 息 一 下 ! 


24 monkey 工 具 总 结 


89, us 同事 私下 说 monkey 不 支持 插件 编写 ， 是 这 样 吗 ? 
和 iere 

05... 好 啦 ， 我 不 想 听 你 解释 ， 还 有 同事 跟 我 说 ，monkey 连 截屏 都 不 支持 ， 是 吗 ? 

DS cert AKA, FLD RERARNE, FAS TAOARDLATUAMAPERALAB OMEN, SR, ANHERT UTR ERA, 
Qus cnneces, dot baba GO TEE ARGUS ROO 

eo. ees 我 个 人 认为 我 们 更 应 该 关注 如 何 利用 好 monkey 的 优势 ， 而 不 是 盯 着 它 的 弱项 不 放 。 

WO 得 了 吧 ， 再 这 样 说 下 去 我 会 直接 质疑 你 的 能 力 ， 我 还 听 说 monkey 没 办 法 控制 事件 流 ， 对 吗 ? 

eo... 也 是 有 方法 可 以 做 到 的 …… 

Bc ohh, eck ee, HE Ree ee al ee? 


[PTT 外 给 你 推荐 一 款 工 具 了 ! 


A 


http://www.cnblogs.com/armlinux/archive/2011/11/24/2396778.html, 
2) http://blog.csdn.net/lichaoandy/article/details/6565893, 
3) http://blog.csdn.net/applezp/article/details/7651885, 


4) http://blog.csdn.net/neiloid/article/details/7893755, 





5) http://blog.csdn.net/kickxxx/article/details/7482392, 


第 3 章 monkey 之 子 monkeyrunner 使 用 详解 





加 不 要 指望 让 我 monkey 去 做 我 做 不 了 的 事 ， 这 些 事 就 交 给 我 儿子 去 做 吧 1 


3.1 monkeyrunner 概 述 
06, 我 个 要 看 看 你 推荐 的 这 款 工具 能 不 能 完全 满足 我 的 需求 ! 
i» 
fem, Rd AM edite RB? 


85, . ，monkeyrunner 可 比 monkey 要 强大 得 多 ! 不 过 咱们 也 要 清楚 ， 道 高 一 尺 ， 魔 高 一 克 ， 先 看 看 她 的 反应 再 说 ! 























正如 在 monkey 工 具 总 结 中 所 言 ，monkey 虽 然 很 强大 ， 但 它 毕竟 是 一 款 为 稳定 性 测试 准备 的 小 工具 一 一 它 很 难 支持 插件 编写 ， 也 不 提供 截屏 功能 ， 对 数 和 
回放 这 样 的 功能 (事实 上 ， 通 过 调用 monkey 完 成 录制 和 回放 的 脚本 和 小 工具 很 多 ， 这 里 是 针对 它 自身 情况 而 言 ) 。 




































































既然 monkey 做 不 到 ， 那 我 们 就 将 希望 寄托 在 它 “ 儿 子 ” 身 上 一 一 monkeyrunner 应 运 而 生 ! 




















下 面 ， 就 让 我 们 一 起 见证 长 江 后 浪 推 前 浪 ， 青 出 于 蓝 而 胜 于 蓝 的 测试 利器 monkeyrunner 吧 ! 


3.2 monkeyrunner APl 详 解 


居 流 控制 的 能 力 很 微弱 ， 更 无 法 完成 像 录制 、 


,A 如 代码 清单 3-1 所 示 。 


代码 清单 3-1 monkeyrunner 示 例 脚本 





# This is a monkeyrunner script created by BugBen 

# This script will test the bugben.apk 

# See http://developer.android.com/tools/help/MonkeyRunner.html 
# 


# Usage: monkeyrunner TestMonkeyRunner Demo.py 

# Import monkeyrunner modules T 

import sys 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice, MonkeyImage 
# Parameters 


txtl_x = 327 
txtl y = 231 
txt2 x = 327 
txt2 y = 375 
bold x = 500 
bold y = 600 
small x = 327 
small y = 744 





submit x = 555 

submit y = 999 

type = 'DOWN AND UP' 

seconds - 1 

txtl msg "bugben" 

txt2 msg = 'bugben' 

# Package name and activity name 

package = 'com.xuben.hellobugben' 

activity = '.ChangeActivity' 

component = package + '/' + activity 

# Connect device 

device = MonkeyRunner.waitForConnection () 

# Install HelloBugben.apk 

device.installPackage ('./HelloBugben.apk") 

print ‘Installing HelloBugben.apkhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/...' 
# Launch bugben 

device.startActivity (component) 

print 'Launching bugbenhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15501/OEBPS/Text/...' 
# Wait 1s 

MonkeyRunner. sleep (seconds) 

# Input txtl 

device.touch(txtl x, txtl y, type) 

device.type(txtl msg) 

device.press('KEYCODE ENTER','DOWN AND UP') 

print 'Inputing txtlhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/..." 
# Input txt2 

device.touch(txt2 x, txt2 y, type) 

device.type(txt2 msg) 

device.press('KEYCODE ENTER','DOWN AND UP') 

print 'Inputing txt2http: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15501/OEBPS/Text/...' 
# Select bold 

device.touch(bold x, bold y, type) 

print 'Selecting boldhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/...' 
# Select small 

device.touch(small x, small y, type) 

print 'Selecting smallhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/...' 
# Wait 1s 

MonkeyRunner. sleep (seconds) 

* Submit 

device.touch(submit x, submit y, type) 

print 'Submittinghttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/..."' 

* Wait 1s 

MonkeyRunner. sleep (seconds) 

# Get the snapshot 

picture - device.takeSnapshot () 

picture.writeToFile('./bugben pic.png', 'png') 

print 'Complete! See bugben pic.png in current folder' 

# Back to home 

device.press('KEYCODE HOME','DOWN AND UP') 

print 'Back to HOME." 





Qi 为 避免 乱码 ， 本 章 脚本 中 的 注释 一 律 用 英文 ， 首 行 注释 为 作者 信息 ， 第 2 行 注释 为 脚本 用 途 ， 第 3 行为 相关 API 地 址 。 


第 5 行 Usage 是 其 在 linux 上 的 用 法 ， 在 Windows 上 应 改 为 “monkeyrunner.bat XXX.py”， 其 中 XXX.py 为 脚本 名 ， 如 当前 脚本 在 Windows 命 令 行 下 应 改 为 : 





"monkeyrunner.bat TestMonkeyRunner Demo.py". 





为 节省 本 书 空间 ， 后 续 将 只 保留 Usage 这 行 注释 ， 大 家 在 正式 写 脚本 时 建议 以 此 为 准 。 


将 以 上 脚本 存 为 TestMonkeyRunner_Demo.py 并 运行 ， 运 行 完成 后 打开 同 级 目录 中 保存 的 结果 截图 : bugben_pic.png， 如 图 3-1 所 示 。 











bugben 


bugben 


bugben 











图 3-1 运行 结果 截图 : bugben pic.png 











命令 行 实时 运行 情况 如 图 3-2 所 示 。 











D: \xuben too ls \Wwork\CTS \android-sdk-windows4.2\tools >monkeyrunner TestMonkeyRun 
er_Demo.py 

Installing HelloBughen.apk... 

Launching bughen... 

Inputing txti... 

Inputing txt2... 

Selecting bold... 


Selecting small... 

Submitting... 

Complete! See bugbhen_pic.png in current folder 
Back to HOME. 





图 3-2 命令 行 实时 运行 情况 
©. EF 意 ”如 果 在 Windows 环 境 下 运行 ， 需 要 进行 如 下 操作 。 
1) 配置 Python 环 境 。 


2) 通过 SDK (如 “~\android-sdk-WindowsXXX\tools”) 下 的 MonkeyRunner.bat 运 行 monkeyrunner TestMonkeyRunner_Demo.py。 


3) 本 脚本 需 提 前 将 HelloBugben.apk 拷 贝 到 与 脚本 同 级 目录 中 。 


BS gccrma, 有 什么 感觉 没 ? 


SERED IA EMR AAT AG? 我 想 知道 MonkeyRunner、MonkeyDevice 和 Monkey-Image 这 几 个 导入 包 都 包含 些 什么 ? 


Guz MonkeyRunner、MonkeyDevice 和 MonkeyImage 的 API 官 网 地 址 如 下 。 
+ MonkeyRunner: http:/ /developer.android.com/tools/help/MonkeyRunner.html o 
+ MonkeyDevice: http:/ /developer.android.com/tools/help/MonkeyDevice.html o 


+ MonkeyImage: http:/ /developer.android.com/tools/help/MonkeyImage.html o 


人 A% 哇 ， 这 么 麻烦 ， 你 先 给 我 大 致 讲 讲 吧 ， 让 我 心里 多 少 有 个 底 ， 嘿 嘿 ! 


monkeyrunner 的 API 主 要 分 为 3 类 ， 如 图 3-3 所 示 。 
































先 来 看 看 MonkeyRunner API， 这 个 类 提供 了 用 于 连接 monkeyrunner 和 设备 或 仿真 器 的 方法 ， 也 为 创建 monkeyrunner 程 序 的 用 户 界面 和 显示 帮助 提供 了 方法 ， 如 图 3-4 所 示 。 











MonkeyRunner 


图 3-3 monkeyrunner 的 API 分 类 
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API 
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API 





Monkeylmage 
API 


MonkeyRunner Y 
API 





3-4 Monkey 




















JAMonkeyRunner API 中 的 waitForConnection() 方 法 引出 了 MonkeyDevice。 接 下 来 我 们 看 看 MonkeyDevice， 这 个 类 为 安装 、 卸 载 应 用 、 发 送 广播 、 启 动 Activity、 获 取 设 备 属性 、 运 行 测试 包 、 基 
本 操作 、 发 送 按键 和 触摸 事件 等 提供 了 方法 ， 可 以 看 出 ， 这 部 分 AP| 是 我 们 关注 的 焦点 所 在 ， 如 图 3-5 所 示 。 























从 MonkeyDevice APl 中 的 takesnapshot() 方 法 又 引出 了 Monkeylmage， 这 个 类 为 截图 、 图 像 保 存 、 图 像 对 比 、 将 位 图 转换 成 各 种 格式 、 图 像 截 取 和 获取 坐标 点 像素 值 等 提供 了 方法 ， 如 图 3-6 所 示 。 






























getSystemPrope 获取 当前 
rty() 设备 属性 


mE" E zr: Vy FH | 










MonkeyDevice 
API 


HH 
a 
a 
dH 


instrument() 
press() 
reboot() 


removePackage() 


startActivity() 


touch() 


type() 


d 


uil 
Ht 


执行 测试 用 例 
4% 


删除 指定 
Package 


3 
ji 
8 
dp 


wake() 唤醒 设备 


takeSnapshot() 


: 
M 


convertToByte 


s() 转换 图 像 格 式 





getRawPixel() "EN 


getRawPixellnt() MEET 





Monkeylmage 


API 
图 像 对 比 


保存 图 像 文件 


writeToFile() 


截取 子 图 像 


getSublmage() 





图 3-6  MonkeyImage API 
Qaare, 是 不 是 有 种 似曾相识 的 感觉 ? 
E 
TUR, $t KARA AR Monkey € d Jit, A denos RF HY HARA! 让 我 想 想 都 见 过 哪些 …… 
3.2.1 monkeyrunner&KAPI: 手势 、 输 入 和 点 击 


Se 
全 首先 自然 是 手势 、 输 入 和 点 击 操作 ， 我 得 找 找 Monkeyrunner 是 如 何 实现 的 。 





下 面 ， 我 们 对 比 一 下 monkey 和 monkeyrunner 在 手势 、 输 入 和 点 击 操作 上 的 异同 ， 如 图 3-7 所 示 。 











monkey 手势 : 
monkey 通过 轨迹 球 事 件 


DispatchTrackball $A, action. 
x, y 进行 拖 搜 操作 。 先 在 A 点 
(xLy1) 按 下 , 再 在 B 点 (x2,y2j 暗 起 


monkeyrunner 手势: 
通过 MonkeyDevice 的 
drag() 方 法 直接 传 入 AR j 
和 B 点 的 坐标 即 可 进 
拖 搜 操作 


monkey 点 击 : 

monkey 通过 点 击 事 件 
DispatchPointer 传 入 action: x; 
y 进行 点 击 操作 ,。 先 在 A 点 (x1,y1) 
按 下 ， 再 在 A 点 (xly1) 弹 起 


monkeyrunner 点 击 : 
通过 MonkeyDevice 的 
touch) AEEA A SAB 
标 ， 并 通过 

DOWN. AND UP 

参数 直接 完成 点 击 


图 3-7 monkey 父 子 在 手势 、 输 入 和 点 击 操作 上 的 异同 


从 哈 哈 ， 轻 轻松 松 就 把 这 3 个 对 应 的 基本 功能 找 出 来 了 ， 原 来 都 是 MonkeyDevice 的 API 呵 ! 


monkey 输入 : 

monkey 通过 输 六 字 串 事件 
DispatchString EA text 进行 
输入 操作 


monkeyrunner 输入 : 
通过 MonkeyDevice 的 
type) AEEA text 进行 
输入 ， 与 monkey —£X 





EE ， 下 面 咱们 一 起 看 看 这 3 个 基本 API 具 体 如 何 使 用 吧 ! 


1. 拖 搜 





void drag(tuple start, tuple end, float duration, integer steps) 





Gx 在 设备 屏幕 上 模拟 拖 搜 手 势 (touch, hold, movet) 。 




















对 于 drag， 只 需要 了 解 其 起 止 点 的 位 置 即 可 ， 持 续 时 间 和 步 数 都 可 以 使 用 默认 值 。 
参数 详细 说 明 如 下 。 

‘tuple start， 拖 搜 起 始 位 置 ， 为 tuple 类 型 的 (x,y) 坐 标点 。 

“tuple end， 拖 搜 终点 位 置 ， 为 tuple 类 型 的 (xy) 坐 标点 。 

“ float duration， 拖 搜 手 势 持续 时 间 ， 默 认为 1.0s。 


‘integer steps， 插 值 点 的 步 数 ， 默 认 值 为 10。 





脚本 样 例如 代码 清单 3-2 所 示 。 


代码 清单 3-2 drag_ monkeyrunner bugben.py 





# Usage: monkeyrunner drag monkeyrunner bugben.py 

# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
# Prepare start and end with 12 steps in 1.5s 

start = (400, 200) 

end - (60, 200) 

duration - 1.5 

steps - 12 


# Connect to the current device 

device = MonkeyRunner.waitForConnection () 
# Swipe from start to end 
device.drag(start, end, duration, steps) 





Gx 以 上 是 将 巴 哥 奔 当 前 手机 下 应 用 菜单 从 第 一 页 翻 到 第 二 页 的 坐标 拖 搜 GELstatACTHS HFRS GAM, endASHFMRAM GAM) ， 有 具体 坐标 请 大 家 自行 尝试 。 


2. 输 入 





void type(string message) 





lo 输入 字符 串 到 设备 。 




















对 于 type， 我 们 只 需 直接 输入 字符 串 即 可 实现 输入 操作 。 


参数 详细 说 明 如 下 。 





string message， 输 入 字符 串 。 
脚本 样 例如 代码 清单 3-3 所 示 。 


代码 清单 3-3 type monkeyrunner bugben.py 





# Usage: monkeyrunner type monkeyrunner bugben.py 

# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 

# Parameters 

txtl x = 327 

txtl y = 231 

type = 'DOWN AND UP' 

seconds = 1 

txtl msg = 'xiaojianjie' 

# Package name and activity name 

package = 'com.xuben.hellobugben' 

activity = '.ChangeActivity' 

component = package + '/' + activity 

# Connect device 

device = MonkeyRunner.waitForConnection () 

# Install HelloBugben.apk 

device. installPackage ('./HelloBugben.apk"') 

print 'Installing HelloBugben.apkhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/...' 
# Launch bugben 

device.startActivity (component) 

print 'Launching bugbenhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/..."' 
# Wait 1s 

MonkeyRunner. sleep (seconds) 

# Input txtl 

device.touch(txtl x, txtl y, type) 

device.type(txtl msg) 

device.press('KEYCODE ENTER','DOWN AND UP') 

print 'Inputing txtlhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/..." 








进入 bugben 应 用 并 在 文本 框 1 中 输入 “xiaojianjie”， 如 图 3-8 所 示 。 


Teck? 屏幕 下 方 为 何 出 现 一 根 白 条? 


Se 眼睛 很 尖 嘛 ! 这 其 实 是 在 使 用 搜狗 输入 法 输入 后 的 残留 部 分 。 这 就 是 通过 自动 化 脚本 和 手动 输入 的 差别 所 在 。 





$29, 3 UR d CRAE2US AERA AMMA, FRYBORP ERT. AMIR, HRA FAT, A ARATE RRRA ERS ERG EYAL 
UU A EE JE S68 e XE? 


从 全 ma， 大 家 会 认为 在 type 后 发 送 Enter 键 没有 意义 ， 因 为 type 就 会 输入 。 但 在 实际 项 目 中 ， 巴 哥 奔 发 现 一 般 手机 都 会 内 置 输入 法 (如 搜狗 ) ， 而 type 会 调用 这 些 输入 法 。 


虽然 理论 上 不 发 送 Enter 键 也 可 以 实现 输入 ， 但 在 实际 项 目 中 就 可 能 出 错 ， 如 图 3-9 所 示 。 





in 





请 在 下 框 中 输入 希望 修改 的 文字 : 


va br Xxiaojianjie 


ij Ed DBuogbenQQ:1971629467 





had 


© = sei OO 14:55 





veya BUgben 微 信 : EE 


Wyss BugbenQOQ:1971629467 


请 选择 你 喜欢 的 颜色 : 
viv. 1782: (aa (aa 
AEE: O) (3) aine 


i 本 框 ? 大 /| i? ( ` ka ( E Y 大 号 


XIaojranjle 


| . se T 
xiantantiue 





图 3-9 ”输入 出 错 


E 输 入 到 文本 框 19 





H 





在 删 掉 发 送 Enter 键 这 句 后 ， 脚 本 执行 的 结果 “xiaojianjie” 还 在 搜狗 输入 法 中 ， 并 没有 真 


Seok, KGcAT! 


$6, ,,. 永远 不 要 把 结果 看 得 这 样 理所当然 ， 这 也 是 从 事 自 动 化 工作 必 备 素质 之 一 。 


void touch(integer x, integer y, integer type) 


o E A i touch event 事 件 模拟 点 击 。 

















Im 
> 





对 于 touch， 我 们 只 需要 了 解 其 坐标 值 和 按键 类 型 (一 般 为 DOWN_AND_UP) 即 可 。 








参数 详细 说 明 如 下 。 

- integerx，x 坐 标 值 。 

“integer y，y 坐 标 值 。 

' integer type, key event 类 型 (如 DOWN、UP、DOWN_AND_UP) 。 

o = ” DOWN 为 按 下 事件 ，UP 为 弹 起 事件 ，DOWN_AND_UP 为 按 下 弹 起 事件 。 


脚本 样 例如 代码 清单 3-4 所 示 。 





代码 清单 3-4 touch monkeyrunner bugben.py 





* Usage: monkeyrunner touch monkeyrunner bugben.py 
# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
# Prepare x, y, type 

x = 45 

y = 185 

type = 'DOWN AND UP' 

* Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# touch the first application 

device.touch(x, y, type) 





























D 





找到 桌面 左上 方 第 一 个 应 用 bugben， 如 图 3-10 所 示 ， 自 动 打 开 该 应 用 ， 如 图 3-11 所 示 。 





















































bugben 





bugben 


请 在 下 框 中 输入 希望 修改 的 文字 : 





请 选择 你 喜欢 的 颜色 : 
d ( ) 加 粗 © 不 加 粗 


文本 框 2 大 小 : 





drag() Jti 1 





MonkeyDevice 击 


MonkeyRunner API f 





Monkeylmage type() 输入 


API 





图 3-12 monkeyrunner 基 本 API 总 结 
3.2.2 ”monkeyrunner 必 备 APl: 启动 应 用 、 等 待 


i» 
全 % 接 下 来 是 启动 应 用 、 等 待 和 开关 软 键盘 ， 一 眼 就 看 出 来 了 哦 | 











下 面 ， 我 们 对 比 一 下 monkey 和 monkeyrunner 在 应 用 启动 、 等 待 和 开关 软 键盘 等 操作 上 的 异同 ， 如 图 3-13 所 示 。 































monkey 软 键盘 : 
monkey 通过 开关 软 键盘 事 
件 pispatchFlip 进行 键盘 
控制 

monkeyrunner 无 对 应 方法 










monkey faa Ri: monkey 等 待 : 

monkey 通过 局 动 应 用 事件 monkey 通过 等 待 事件 Userwait 传 入 sleeptime 
LaunchActivity 传 入 包 名 (pkg_namej 和 应 单位， See) 进行 等 待 操作 

用 名 (cl_name) 实 现 应 用 启动 操作 







monkeyrunner 尼 动 应 用 : monkeyrunner 等 待 : 


通过 MonkeyDevice 的 startActivity() 方 通过 MonkeyRunner 的 sleep) AEEA 
法 直接 传 入 component ( 即 包 名 与 应 用 seconds (单位 ， 秒 ) 进行 等 待 操作 
名 的 组 合 ) 即 可 局 动 该 应 用 


图 3-13 ”monkey 父 子 在 应 用 启动 、 等 待 和 开关 软 键盘 等 操作 上 的 异同 


i» 
全 5 唱 ， 这 两 个 也 不 难 找 ， 好 吧 ， 下 面 看 看 具体 应 用 1 














1. 启 动 应 











void startActivity(string uri, string action, string data, string mimetype, iterable categories, dictionary extras, component component, flags) 





Gx 启动 设备 上 的 应 用 。 











对 于 startActivity， 我 们 只 需要 了 解 其 component (组 件 ) 即 可 ， 其 余 均 可 默认 ，component 由 该 应 用 的 package 和 activity 组 成 。 

参数 详细 说 明 如 下 。 

“ sttinguri， 设 置 Intent 的 URI， 参 见 Intent.setData0 o 

“ stting action， 设 置 Intent 的 Action， 参 见 Intent.setAction()。 

“string data， 设 置 Intent 的 Data， 参 见 Intent.setData() o 

“ string mimetype， 设 置 Intent 的 MIME type, #JUIntent.setType(. 

- iterable categories， 设 置 Intent 的 Categories， 参 见 Intent.addCategory()。 
* dictionary extras ， 设 置 Intent 的 extra data， 参 见 Intent.putExtra()。 
component component， 设 置 Intent 的 ComponentName。 

- iterable flags ， 设 置 Intent 的 Flag， 参 见 Intent.setFlags0。 

脚本 样 例如 代码 清单 3-5 所 示 。 


代码 清单 3-5 startActivity monkeyrunner bugben.py 





# Usage: monkeyrunner startActivity monkeyrunner bugben.py 
# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
import sys 

# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Prepare settings component 

package = 'com.android.settings' 

activity = '.Settings' 

component = package + '/' + activity 

# Start settings activity 

device.startActivity (component) 











系统 设置 应 用 被 启动 ， 如 图 3-14 所 示 。 





























3-24 系统 应 用 被 启动 











2. 等 待 





void sleep(float seconds) 





Oa 暂停 当前 程序 ， 等 待 。 
对 于 sleep() 方 法 ， 我 们 只 需要 了 解 其 等 待 时 间 (单位 为 秒 ) 即 可 。 
参数 详细 说 明 如 下 。 


float seconds， 等 待 时间 ， 单 位 为 s (Eb) 。 





脚本 样 例如 代码 清单 3-6 所 示 。 





代码 清单 3-6 sleep monkeyrunner bugben.py 





# Usage: monkeyrunner sleep monkeyrunner bugben.py 

# Import the monkeyrunner modules e 

from com.android.monkeyrunner import MonkeyRunner 

# Prepare txt and html format 

message = 'Please input bugben QQ:' 

initialValue = '1971629467' 

title = 'BugBen' 

okTitle = 'save' 

cancelTitle = 'cancel' 

seconds = 5 

# Prompt the input dialog and displayed on alert dialog 
bugbenQQ = MonkeyRunner.input (message, initialValue, title, okTitle, cancelTitle) 
MonkeyRunner. sleep (seconds) 

MonkeyRunner.alert (bugbenQQ, title, okTitle) 





与 “输入 ”例子 唯一 的 不 同 是 ， 在 这 里 输入 框 关 闭 后 等 待 了 5s 后 警告 框 才 弹 出 。 





monkeyrunner 必 备 AP| 总 结 如 图 3-15 所 示 。 
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MonkeyRunner 
API 

















MonkeyDevice startActivity() 启动 应 用 


MonkeyRunner API 






Monkeylmage 
API 






图 3-15 monkeyrunnerse 4APLY 25 


曲 1: 从 获取 包 名 应 用 名 到 SL4A 

















在 说 明 monkey 脚 本 编写 时 ， 我 们 曾 讨 论 过 如 何 获取 包 名 和 应 用 名 。 





查看 包 名 ， 运 行 下 列 命令 。 


$ adb shell 
# 1s data/data 





运行 结果 如 图 3-16 所 示 。 





D:\xuben \andro id-sdk-windows4.2\tools>adb shell 
rootCandroid:/ # ls data/data 

ls data/data 

com.IdeaFriendSecreteCode 
com.android.backupconfirm 


com.android.cellbroadcastreceiver 
com.android.certinstaller 
com.android.defcontainer 
com.android.dolbymobileaudioeffect 
com.android.galaxy4 
com.android.gallery3d 
com.android.inputdevices 








图 3-16 BAAS 








发 现 浏览 器 的 包 名 为 com.android.browser， 查 看 应 用 名 代码 。 














$ adb shell 
# logcat | busybox grep START 


运行 结果 如 图 3-17 所 示 。 





I/ActivityManager< 524): START <act=android.intent.action.MAIN cat=Landroid.int 
ent .category.LAUNCHER] f1g=6x16266006 cmp-com.android.browser/.Brouserfictivity b 


ds =(384,752 11480.8481] u=@> from pid 876 











图 3-17 查看 应 用 名 














从 “cmp=com.android.browser/.BrowserActivity” 这 名 可 以 看 出 ， 浏 览 器 的 应 用 名 为 com.android.browser.BrowserActivity。 


全 除了 这 种 方法 ， 还 有 别 的 办 法 吗 ? 














e,, 我 们 还 有 一 种 更 准确 的 获取 包 名 和 应 用 名 方法 。 








获取 包 名 和 应 用 名 ， 如 代码 清单 3-7 所 示 。 











代码 清单 3-7  displayPkgandApp bugben.py 





# Usage: displayPkgandApp bugben.py 
# Import the android 

import android 

# Get android object 

droid = android.Android() 

# Get package list 

pkgs = droid.getRunningPackages () 

# Get app list 


apps = droid.getLaunchableApplications () 


# Print package list 
print pkgs.result 
# Print app list 
print apps.result 








但 运行 该 脚本 时 报错 ， 如 图 3-18 所 示 。 





D: \xuben \android-sdk—-windows4.2\tools>displayPkgandfpp_bugben. py 
Traceback “most recent call last): 

File “D:\xuben\android-sdk—-windows4.2\tools\displayPkgandfpp_bughben.py". line 
4, in <module> 


import android 
ImportError: No module named android 


D: \xuben \android-sdk-windows4.2\tools> 


se 
全 5 为 什么 会 这 样 ? 


9o 因为 缺少 Android 脚 本 运行 环境 。 








3-18 运行 脚本 报错 











这 里 可 以 搭建 SL4A ( 即 Scripting Layer for Android) 这 样 一 个 Android 脚 本 解释 环境 。 











Android 脚 本 官网 地 址 为 http://code.google.com/p/android-scripting， 打 开 后 出 现 如 图 3-19 所 示 的 页 面 。 


aJ android-scripting - Scriptin... X 





| € ) A https://code.google.com/p/android-scripting/ 








Summary People 


Project Information 
Project feeds 


Code license 


Apache License 2.0 


Labels 

Google, Android, Lua, 
BeanShell, Scripting, 
Python, Perl, JRuby, Tcl, 
JavaScript, Ruby, Shell 


SL4A3z##Python, Perl, PHP, JRuby, 
， 非 常 方便 。 


SL4A's source has moved to github. The issue tracker, wiki, and downloads will continue to be hosted here. 





Scripting Layer for Android (SL4A) brings scripting languages to Android by allowing you to edit and execute scripts and interactive interpreters 
directly on the Android device. These scripts have access to many of the APIs available to full-fledged Android applications, but with a greatly 
simplified interface that makes it easy to get things done. 


Scripts can be run interactively in a terminal, in the background, or via Locale. Python, Perl, JRuby, Lua, BeanShell, JavaScript, Tcl, and shell are 
currently supported, and we're planning to add more. See the SL4A Video Help playlist on YouTube for various demonstrations of SLAA's features. 


SL4A is designed for developers and is alpha quality software. Please report bugs and feature requests on the issues list. You can download the 


current APK by scanning or clicking the fi barcode: 











图 3-19 ”Android 脚 本 官网 
































BeanShell 和 Lua 等 多 种 脚本 引擎 ， 在 该 环境 下 可 直接 执行 这 些 脚本 语言 编写 的 脚本 一 一 对 脚本 进行 解释 并 以 远程 过 程 调 用 (RPC) 的 方式 调用 其 Android 接 











单 击 最 新 的 sl4a_r6.apk 链 接 ， 下 载 最 新 的 sl4a， 如 图 3-20 所 示 。 











wnload | slda (G.apk SL4A Release B Featured 
Sleep Extras R1 


Download sleep extras r1.zip 
Download sleep scripts rl.zip Sleep Sample Scripts R1 
Download textedit-sl4a.apk TextEdit for Sl4a 


图 3-20 sl4a_r6.apk 下 载 列表 
完成 下 载 后 ， 通 过 adb install sl4a_r6.apk 安 装 即 可 ， 如 图 3-21 所 示 。 


D: \xuben \too ls \work\CTS \android-sdk-windows4.2\tools>adb install sl4a_r6-.apk 


adb server is out of date. killing... 
* daemon started successfully * 
2058 KB/s (88774? bytes in 9.421s) 
pkg: /data/local/tmp/sl4a_r6.apk 


Success 


图 3-21 安装 sl4a 应 用 


安装 完成 后 ， 初 次 进入 ， 点 击 Accept， 然 后 点 击 菜单 键 ， 如 图 3-22 所 示 。 点 击 View 一 interpreters， 进 入 到 脚本 运行 界面 ， 如 图 3-23 所 示 。 


Scripts 
No matches found. 





Q, 


Search 


Preferences Refresh 


Interpreters 


[Æ] Shel 





< 


Start Serwer 


图 3-23 sl4a 脚 本 运行 界面 


点 击 Add， 在 弹出 菜单 中 选择 Python 2.6.2， 如 图 3-24 所 示 。 此 时 将 自动 打开 浏览 器 开始 下 载 PythonForAndroid_r4.apk， 在 完成 下 载 后 点 击 该 apk 即 可 进入 安装 界面 ， 如 图 3-25 所 示 。 


BeanShell 2.0b4 





JRuby 


Lua 5.1.4 


PHP 5.3.3 


Perl 5.10.1 


Python 2.6.2 


Rhino 1.7R2 





Do you want to install this 
application? 


Allow this application to: 
ww Storage 
modify/delete 5D card contents 


~ Network communication 


full Internet access 


Phone calls 
read phone state and identity 


图 3-25 ”安装 python for Android 


安装 完 即 可 在 桌面 看 到 python for Android， 如 图 3-26 所 示 。 点 击 打开 该 应 用 ， 如 图 3-27 所 示 。 








Python for Android 


Install 


Latest Versions, interpreter: 16, extras: 14, scripts: 
13 

Installed Versions, interpreter: ND, extras: ND, 
scripts: ND 


Import Modules 


Browse Modules 


Uninstall Module 








图 3-27 python for Android 应 用 界面 


点 击 install 按 钮 ， 将 进行 相关 库 文件 下 载 ， 下 载 完 成 后 ，install 将 变 成 Uninstall， 表 示 安 装 完成 ， 如 图 3-28 所 示 。 再 次 打开 SL4A， 发 现 多 了 很 多 .py 的 脚本 ， 如 图 3-29 所 示 。 





















































Python for Android 
Uninstall 
— Versions, interpreter: 16, extras: 14, scripts: 
| 
Installed Versions, interpreter: 16, extras: 14, 


scripts: 13 


Import Modules 


Browse Modules 


| Uninstall Module 





Scripts 
P bluetooth, chat.py 

P" displayPkgandApp_bugben.py 
P" hello. world.py 

P" notify weather.py 

- say chat.py 

P" say_time.py 


" say. weather.py 


fes speak.py 





P take picture.py 


P test.py 
P. weather.py 


3-29 python for Android 7 f| Eg A 


这 些 就 是 Python 提供 的 脚本 样 例 ， 大 家 可 以 点 击 查看 运行 效果 。 此 时 再 次 点 击 View->interpreters， 进 入 到 脚本 运行 界面 ， 即 可 看 到 Python 2.6.2 已 经 赫然 在 列 。 此 时 即 可 将 脚本 
displayPkgandApp_bugben.py 拷 贝 到 手机 的 “sl4a\scripts” 中 。 


单 击 displayPkgandApp_bugben.py 脚 本 ， 弹 出 菜单 ， 如 图 3-30 所 示 。 点 击 第 3 个 图 标 (一 支 笔 形状 图 标 ) ， 进 入 编辑 状态 ， 即 可 对 该 脚本 进行 查看 和 编辑 ， 如 图 3-31 所 示 。 


@ bluetooth chat.py 
P displayPkgandApp. bugben.py 





P say. weather.py 
P" speak.py 

P" take_picture.py 
- test.py 

(- weather.py 


displayPkgandApp. bugben.py 


8 Usage: displayPkgandApp bugben.py 


8 Import the android 
import android 


# Get android object 
droid = android.Android() 


& Get package list 
ma la mm = "—— si -æ m de Ps n 


m d oum m om mmm T TR 





PRES = uruiu.peinmunmiingrackdgest J 
# Get app list 
appssdroid.getLaunchableApplications() 


# Print package list 
print pkgs.result 
& Print app list 
print apps.result 


ELE EE 
2l C d Ed 3 











图 3-31  displayPkgandApp_bugben.py Eg A 




















按 后 退 键 退出 后 点 击 菜单 第 一 个 图 标 (命令 行 形状 图 标 ) ， 即 可 在 SL4A 中 执行 该 脚本 ， 运 行 结果 如 图 3-32 所 示 。 


























dlopen libpython2.6.so0 

[u'com. lenovo.exchange’, u'com.android.defcontainer', u'com.tencent.mm', u'com. lenovo. calendar’, u'com.android.phone', u'com. lenovo.wifiswitch', u'com, lenovo. email', u'com. lenovo. F 
ileBrowser', u'com. lenovo. smartrotation', u'com.sohu. inputmethod.sogou', u'com. lenovo. powercenter', u'com.android. bluetooth u'com. lenovo. lsf.device', u'com. android. providers. calel 
ndar', u'com.qualcomm. logkit', u‘com.qualcomm.gsmtuneaway', u'com.qq.reader’, u'com.dsi.ant.server’, u'com. lenovo. safebox', u'com.android.stk', u'com.qualcomm.msapm', u'com. android 
.providers.userdictionary', u'com. lenovo. lewea', u'com.lenovo.weatherserver', u'com.lenovo.ideafriend', u'com. lenovo, themecenter', u'com. android. providers.media’, u'org.codeaurora. 
bluetooth’, u'com.xuben.hellobugben', u'com, googlecode.pythonforandroid', u'com.googlecode. android scripting’, u'com, lenovo. lsf', uy'com, lenovo.ue.service’, u'android', u'com. androi 
d.providers.contacts', u'com.android.settings', u'com.qualcomm. location’, u'com. lenovo. leos.simsettings’, u'com. android. incallui’, u'com. lenovo.music', u'com. lenovo.ncservice’, u'a 
om. lenovo.widetouch', u'com. lenovo. leos.appstore’, u'com. lenovo. launcher’, u'com.android.systemui', u'com.android.providers.telephony', u'com, baidu. BaiduMap', u'com. android. provide 
rs.settings', u'com. lenovo.multiwindow', u'com.qualcomm.display', u'com.android.keyguard', u'com.qualcomm.services. location’, u'com. android. providers.downloads’, u'com. lenovo. safec| 
enter’, u'com. lenovo. euservice’] 

{u'\u7535\u8bdd": u'com, lenovo. ideafriend. alias.DialtactsActivity’, u'\ué4e50\u52a9\u624b': u'com. lenovo.magicplus.ui.Main’, u'\u6d4f\u89c8\u5668': u'com. lenovo. browser. BrowserActiv) 
ity’, u'\uS3cb\u7ea6': u'com, lenovo.vctl.weaver. phone. activity. WeaverRoot', u'\u8fbe\u82ac\uS947": u'com. lenovo. launcher. theme. template, ClassicActivity’, u'\u8138\u840cHD': u'com, 
iantan.myofacehd. LoadingPageActivity’, u'Mushroom Wars': u'com.creat.crt.ext.AppGlue', u'\u6307\uS357\u9488': u'com. lenovo. compass. CompassActivity’, u'\uéfel\u606f': u'com. lenovo. 
deafriend.alias.MmsActivity’, u'bugben': u'com. xuben. hellobugben. ChangeActivity', u‘\u817e\u8baf\u65b0\u9Sfb* com, tencent.news.activity.SplashActivity’, u‘\u767e\u5ea6\u5730\uS6) 
e': u'com, baidu. baidumaps,WelcomeScreen', u'\u6469\uS361': u'com, lenovo. launcher. theme, template. ClassicActivity', u'\u8304\uSb50\uSfeb\udsf20': u'com, lenovo. anyshare.ApMainActivity 
", u'SL4A': u' com, googlecode. android scripting. activity. ScriptManager', u'\u8054\u60f3\Uu6587\usef6\u7bal\uSbb6": u'com, lenovo. FileBrowser. activities. FileBrowserMain', u'\u5927\u4f1 
7\u70b9\u8bc4': ul com. dianping.v1.SplashScreenActivity', u'\ude2a\udeba\u70ed\u70b9': u'com. lenovo. android. settings. tether. TetherSettings’, u'\u8054\u60T3\u670d\uS2a1': PRETI 
o. service.LaunchActivity', u'\uS706\uée3b\u9898": u'com. lenovo. launcher. theme. template.ClassicActivity', u'\uSe94\u7528\uSb9d': u'com. tencent. assistant. activity.SplashActivity', u' 
\uGef 4\uGef4\u6253\u8T66': u'com. didi. frame,MainActivity’, u'\uée50\u7701\u7535": u'com. lenovo. powercenter.ui.SplashActivity', u'Python for Android’: u'com. googlecode. pythonforandr 
oid. PythonMain’, u'\u6S5f6\uS149": u'com. lenovo. launcher. theme. template. ClassicActivity', u'\u7528\u6237\ude2d\uSfc3': u'com. lenovo. leos. lenovoservicesetting. activitys.FirstStepAct 
ity’, u'\u7231\u8f6c\u89d2": u'com. lenovo. launcher. theme. template. ClassicActivity’, u'CNGetter': u'com. lenovo. test. CNGetter.CNGetterActivity’, u'QQ\u960S\u8bfb': u'com.qq.reader. 
ctivity.SplashActivity’, u'WPS Office’: u'cn.wps.moffice. documentm 

















3-32 displayPkgandApp_bugben. py Pp A447 








网 


为 便于 大 家 阅读 ， 这 里 将 显示 的 包 名 和 应 用 名 截图 放大 ， 如 











3-33 和 3-34 所 示 。 





u'com. xuben. hellobugben', 
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图 3-34 应 用 名 显示 


ST, RRA BA ATF 





， 这 里 只 是 通过 获取 包 名 和 应 用 名 举 个 例子 ， 其 实在 安装 SL4A 后 ， 绝 大 多 数 脚本 都 可 以 直接 在 手机 上 执行 ， 非 常 方便 ! 


3.2.3 monkeyrunnersEXAPI: 键 值 事件 


£e 


HUG A bl ER, Monkey i) b Rik EAL AURA T, ibo fie f de? 





下 面 ， 我 们 对 比 一 下 monkey 和 monkeyrunner 在 键 值 事件 上 的 异同 ， 如 图 3-35 所 示 。 











按键 





void press(string name, dictionary type) 





lo 3f keycode X i£ key event E ff. 

对 于 press() 方 法 ， 我 们 只 需要 了 解 发 送 的 键 值 和 按键 类 型 即 可 。 
参数 详细 说 明 如 下 。 

- stringname, keycode% o 


* paramdictionary type, key event 类 型 (4eDOWN., UP, DOWN AND UP) 。 


Qa name 需 传 入 keycode 名 而 非 keycode 值 ， 详 见 附录 A。 


DOWN 为 按 下 事件 ，UP 为 弹 起 事件 ，DOWN_AND_UP 为 按 下 弹 起 事件 。 


| monkey 短 按键 值 : monkey 长 按键 值 : monkey 发 送 键 值 : 


monkey 通过 短 按 键 值 事 件 monkey 通过 长 按键 值 事件 LongPress monkey 通过 发 送 键 值 事 件 
DispatchPress 传 keyCode 对 键 传 keyCode 对 键 值 进行 长 按 DispatchKey 传 code 对 发 送 键 
值 进行 短 按 Monkeyrunner 无 对 应 方法 


monkeyrunner 键 值 : 

通过 MonkeyDevice 的 press() 方 法 发 送 
name( 即 keycode), 和 type (BN 

DOWN AND UP 等 ) 来 处 理 键 值 事 件 





图 3-35 monkey 父子 在 键 值 事件 上 的 异同 


脚本 样 例如 代码 清单 3-8 所 示 。 





代码 清单 3-8 Input monkeyrunner bugben.py 


# Usage: monkeyrunner input monkeyrunner bugben.py 

# Import the monkeyrunner modules i 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
# Prepare keycode and type 

name — 'KEYCODE MENU' 

type = 'DOWN AND UP' 

# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Swipe from start to end 

device.press (name, type) 











顺利 弹出 MENU 菜 单 ， 运 行 成 功 ! 如 图 3-36 所 示 。 








@ Sal OCJ 18:50 

















3-36 发 送 菜 单 键 








monkeyrunner 强 大 API 的 总 结 如 图 3-37 所 示 。 





MonkeyRunner 


API 








MonkeyDevice 
API 





MonkeyRunner 





Monkeylmage 


API 


图 3-37 monkeyrunners& X APL& 25 
小 插曲 2: 如 何 通过 monkeyrunner 进 行 长 按 操作 
全 哈哈，Monkeyrunner 倒 是 省 事 ， 不 过 长 按 该 如 何 处 理 呢 ? 
9o, oun 的 ， 教 你 个 小 窍门 ! 你 还 记得 拖 搜 方法 吗 ? 


CHOC, Tite KR HA KAN? 
既然 拖 搜 是 从 A 点 (Xx1,y1) 拖 搜 到 B 点 (x2,y2)， 并 且 拖 搜 方 法 参数 里 还 包含 拖 搜 的 持续 时 间 和 插值 点 步 数 。 


如 果 拖 搜 是 从 A 点 (x1,y1) 拖 搜 到 A 点 (x1,y1)， 且 拖 搜 持续 时 间 较 长 (如 3 秒 ) ， 其 实 就 间接 实现 了 长 按 按键 事件 ， 比 如 我 们 希望 长 按 (300,500) 这 个 点 ， 可 以 通过 如 下 代码 执行 。 





device.drag((300, 500), (300, 500), 3, 10) 





3.24 monkeyrunner 与 PC 交互 API: 输入 、 选 项 列表 框 、 警 告 


人 monkeyrunner 用 区 区 几 个 方法 就 把 他 老 答 给 概括 了 ， 那 接 下 来 咱们 从 哪里 开始 学 习 呢 ? 


|- (ET 我 想 在 运行 过 程 中 通过 PC 与 用 户 进行 交互 ， 比 如 让 用 户 输入 一 句 话 ， 或 者 让 用 户 从 几 个 选项 中 选 一 个 ， 或 者 弹出 个 自 定义 的 警告 框 ， 能 办 到 吗 ? 


ee. ， 不 就 是 通过 PC 与 用 户 进行 简单 交互 吗 ? 


Monkeyrunner— X AAGLMEE A 38 85! 











在 PC 端 弹出 警告 框 、 弹 出 选项 列表 和 输入 等 操作 并 无 对 应 monkey 命 令 ，monkeyrunner 的 对 应 API 如 图 3-38 所 示 。 





BugBen is a cool man 





PC 端 弹出 警告 框 : PC 端 输入 : PC 端 弹出 选项 列表 : 

MonkeyRunner 通过 MonkeyRunner 通过 MonkeyRunner 通过 

alert() 方 法 即 可 在 PC 9m input) A ARNEE PC sim choice( 方 法 即 可 在 PC 端 

弹出 警告 框 以 提示 用 户 弹出 输入 框 以 世 用 户 输 弹出 选项 列表 以 殿 用 户 
六 反馈 选择 





图 3-38 ”monkeyrunnet 在 PC 端 弹出 警告 框 、 弹 出 选项 列表 和 输入 等 操作 上 对 应 的 API 


1.PC 端 输入 





string input (string message, string initialValue, string title, string okTitle, string cancelTitle) 





oe 显示 输入 框 以 供用 户 输入 ， 此 时 程序 将 暂停 以 等 待 用 户 完 成 输入 。 











对 于 Input0 方 法 ， 只 需要 了 解 对 话 框 提示 信息 即 可 ， 其 余 均 可 使 用 默认 。 
参数 详细 说 明 如 下 。 

- string message ， 对 话 框 提示 信息 。 

stringinitialValue ， 输 入 字符 囊 。 

stting title， 对 话 框 标题 ， 上 默认 值 为 Input。 

string okTitle， 对 话 框 中 的 按钮 1， 默 认 值 为 OK。 


- string cancelTitle ， 对 话 框 中 的 按钮 2， 默 认 值 为 Cancel。 





返回 : mad "OK" 按钮 返回 用 户 输入 字 串 ， 点 击 “Cancel” 按 钮 则 返回 空 字 串 。 
脚本 样 例如 代码 清单 3-9 所 示 。 


代码 清单 3-9 Input monkeyrunner bugben.py 





# Usage: monkeyrunner input monkeyrunner bugben.py 

# Import the monkeyrunner modules ni 

from com.android.monkeyrunner import MonkeyRunner 

# Prepare txt and html format 

message = 'Please input bugben QQ:' 

initialValue = '1971629467' 

title = 'BugBen' 

okTitle = 'save' 

cancelTitle = 'cancel' 

# Prompt the input dialog and displayed on alert dialog 
bugbenQQ = MonkeyRunner.input (message, initialValue, title, okTitle, cancelTitle) 
MonkeyRunner. alert (bugbenQQ, title, okTitle) 





弹出 输入 框 如 图 3-39 所 示 ， 里 面 内 容 可 修改 。 











点 击 确定 后 弹出 警告 框 ， 这 里 是 为 了 显示 输入 字符 是 否 被 获取 ， 如 图 3-40 所 示 。 











图 3-39 ”PC 端 弹出 输入 框 





1971629467 








Qi 该 输入 框 在 PC 端 弹出 ， 而 非 手 机 端 弹出 。 


2. 选 项 列表 框 





integer choice(string message, iterable choices, string title) 





Gx 在 当前 脚本 的 运行 过 程 中 显示 选项 列表 对 话 框 。 
参数 详细 说 明 如 下 。 

+ string message ， 对 话 框 中 显示 的 消息 。 

- iterable choices， 一 个 Python 可 遍历 对 象 的 选择 列表 。 

string title， 对 话 框 标题 ， 上 默认 值 为 Input。 

返回 : 选择 后 点 击 “OK” 则 返回 索引 值 (从 0 开始 ) ， 点 击 “Cancel” 返 回 -1。 


脚本 样 例如 代码 清单 3-10 所 示 。 





代码 清单 3-10 choice monkeyrunner bugben.py 





# Usage: monkeyrunner choice monkeyrunner bugben.py 

# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
# Prepare message, choices and title 

message = 'BugBen:' 

choices- ['bugben', 'QO:1971629467', 'http://weibo.com/bugben'] 
title = 'Contact Me' 

# Prompt the choice dialog 

choice = MonkeyRunner.choice (message, choices, title) 








选项 列表 框 如 图 3-41 所 示 ， 点 击 显示 下 拉 列 表 。 


Contact Me 


QQ:1971629467 


Ihttp:/weibo.com/bugben 





图 3-41 











PC 


x 





显示 下 来 列表 框 





void alert(string message, string title, string okTitle) 





Guz 在 当前 脚本 的 运行 过 程 中 显示 警告 对 话 框 。 
参数 详细 说 明 如 下 。 

.stting message， 对 话 框 中 显示 的 消息 。 

.sttingtitle， 对 话 框 标题 ， 默 认 值 为 Alert。 

. stting okTitle， 对 话 框 中 的 按钮 ， 默 认 值 为 OK。 
脚本 样 例如 代码 清单 3-11 所 示 。 


代码 清单 3-11 alert_monkeyrunner_bugben.py 





# Usage: monkeyrunner alert monkeyrunner bugben.py 

# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
# Prepare message, title and okTitle 

message = 'BugBen QQ:1971629467' 

title = 'BugBen is a cool man 

okTitle = 'Contact Me' 

# Prompt the alert dialog 

MonkeyRunner.alert (message, title, okTitle) 





弹出 警告 框 如 图 3-42 所 示 。 





BugBen is a cool man 





BugBen O0:197 1629467 








图 3-42 ”PC 端 弹 出 自 定义 警告 框 


人 呵呵， 有 惊 无 险 ， 总 算 圆满 完成 BOSS 交 代 的 任务 了 ， 吓 我 一 身 冷汗 …… 














monkeyrunner 与 PC 交互 AP| 总 结 如 图 3-43 所 示 。 


PC i^ 


MonkeyRunner 
API 


. Yu 
MonkeyRunner ia c | PCR EH 
API alert() sioe 
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Monkeylmage 


API 





图 3-43  monkeyrunner PC X Z APL 25 


3.2.5 monkeyrunner 应 用 操作 API: 等 待 设备 连接 、 安 装 / 仓 载 应 用 


69, ns 同事 抱怨 说 每 次 测试 一 个 新 应 用 都 得 手动 进行 安装 和 却 载 ， 非 常 麻烦 ， 如 果 每 天 测 30 个 应 用 的 新 版 本 ， 我 估计 他 们 就 会 疯 掉 


“<4, monkeyrunnerA RR, HpRA AEH? 


96,, AGXJERCR. BRA LAABERELE AT, TARR BR, MA ERREAREN, do E E. URBE. MR AFAR ERAAN EE 


























等 待 设备 连接 、 安 装 应 用 和 卸载 应 用 等 操作 并 无 对 应 monkey 命 令 ，monkeyrunner 对 应 API 如 图 3-44 所 示 。 














等 待 设 备 连 接 : 

通过 monkeyrunner 的 通过 MonkeyDevice 的 
waitForConnection() 方 法 installPackage() A 法 将 
等 待 设 备 连 接 到 PS PC 端 应 用 安装 到 设备 上 
连接 失败 ， 将 不 会 继续 

进行 后 续 步 又 


图 3-44 ”monkeyrunner 在 等 待 设备 连接 、 安 装 应 用 和 部 载 应 用 等 操作 上 对 应 的 API 
$e 
TUR, ALARMA 


1. 等 待 设备 连接 


Ust hy FH: 
通过 MonkeyDevice 的 
removePackage() 25 1 E 
载 设备 端 应 用 ， 并 删除 
该 应 用 数据 








MonkeyDevice waitForConnection(float timeout, string deviceId) 





Oez 将 手机 或 模拟 器 与 Monkeyrunner Backend 相 连接 。 





对 于 waitForConnection( 方 法 ， 可 以 完全 不 传 任何 参数 ， 让 其 始终 处 于 等 待 状态 。 
参数 详细 说 明 如 下 。 

* float timeout， 设 置 等 待 超时 时 间 ， 默 认为 始终 等 待 。 

“ string deviceld， 设 备 或 模拟 器 ID 号 。 

返回 : 设备 或 模拟 器 的 MonkeyDevice 实 例 。 


waitForConnection() 方 法 属于 MonkeyDevice， 由 于 有 了 waitForConnection() 方 法 ， 才 能 真正 与 设备 进行 交互 ， 我 们 经 常 看 到 的 如 下 代码 : 








# Connects to the current device 
device = MonkeyRunner.waitForConnection () 








当 只 有 一 个 设备 或 模拟 器 连接 时 ， 可 以 不 带 任何 参数 ， 直 接连 接 该 设备 ， 但 在 有 多 个 设备 时 ， 就 需要 输入 设备 1D 号 。 设 备 1D 号 可 以 通过 如 下 命令 : 





$ adb devices 





该 命令 将 获取 设备 ID 号， 运行 结果 如 图 3-45 所 示 。 





D: \xuben \android-sdk-windows4.2\tools>adb devices 
List of devices attached 


MSM8225QS KUD device 
6123456 789ABCDEF device 





图 3-45 设备 ID 号 


从 中 找到 希望 控制 的 设备 ID 号 ， 如 MSM8225QSKUD， 此 时 就 可 以 通过 如 下 代码 ， 对 该 设备 进行 操作 。 


# Get device ID 

device id = 'MSM8225QSKUD' 

# Connects to the current device 

device = MonkeyRunner.waitForConnection(,device id) 


void installPackage (string path) 


O- 在 安装 Android 应 用 程序 时 ， 如 果 该 应 用 已 被 安装 ， 则 替代 该 程序 。 














对 于 installPackage， 我 们 需要 传 入 该 APK 的 完整 路 径 ， 如 果 该 APK 与 脚本 在 同一 目录 下 ， 则 需要 在 APK 前 面 加 上 “./”， 如“./Bluetooth.apk”。 








参数 详细 说 明 如 下 。 























string path， 提 供需 要 安装 的 应 用 (APK) 的 全 路 径 及 应 用 名 。 




















脚本 样 例如 代码 清单 3-12 所 示 。 





代码 清单 3-12 installPackage monkeyrunner bugben.py 


# Usage: monkeyrunner installPackage monkeyrunner bugben.py 

# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
import sys 

device = MonkeyRunner.waitForConnection () 
device.installPackage('./Bluetooth.apk') 


O- 如 果 找 不 到 一 个 合适 的 APK， 可 以 从 系统 中 找 一 个 出 来 ， 操 作 如 下 : 


Sadb shell 
#ls system/app 


此 时 你 会 看 到 系统 中 存在 的 APK (如 图 3-46 所 示 ) o 


D: \xuben \android-sdk—-windows4.2\tools>adb shell 
root@android:/ # ls system/app 

ls system/app 

AnyS hare .apk 

AppStore .apk 

ApplicationsProvider.apk 

Bac kupRestoreConf irmation.apk 


Bluetooth.apk 


y> ->T - "^! 7 


CellBCSetting.apk 
CellBroadcast Receiver .apk 
CertInstaller.apk 
DataMonitor.apk 
DefaultContainerService.apk 





图 3-46 ”系统 APK 





通过 adb pull 将 你 中 的 APK (如 Bluetooth.apk) 拖 搜 出 来 。 


$adb pull system/app/Bluetooth.apk Bluetooth.apk 





此 时 你 会 看 到 APK 已 经 被 拖 搜 到 当前 路 径 (命令 如 图 3-47 所 示 ， 结 果 如 图 3-48 所 示 ) o 











D: \xuben \Nandroid-sdk-windows4.2\tools>adb pull system/app/Bluetooth.apk 


1234 KB/s (631931 bytes in 6.56@s> 





图 3-47 “导出 系统 APK 命 令 


HithiE(D) [O D:\xuben\android-sdk-windows4.2\tools 


名 称 + 


Bluetooth. apk 618KB APK 文件 








3-48 APK 被 导出 到 当前 文件 来 


















































然后 ， 可 以 通过 上 面 的 脚本 将 其 再 装 回 去 (当然 ， 这 属于 重复 安装 ， 应 该 先 卸载 再 装 ， 这 里 就 不 乾 述 了 ) 。 














3. 印 载 应 











void removePackage (string package) 


lo 删除 指定 包 (package) ， 将 其 中 的 data 和 cache 一 并 删除 。 

对 于 removePackage， 需 要 传 入 完整 的 package 名 ， 如 “com.xuben.hellobugben” 。 
参数 详细 说 明 如 下 。 

string package， 当 前 设备 中 的 package 名 。 


脚本 样 例 如 代码 清单 3-13 所 示 。 





代码 清单 3-13 removePackage monkeyrunner bugben.py 


# Usage: monkeyrunner removePackage monkeyrunner bugben.py 

# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner ,MonkeyDevice 
# Package name 

package = 'com.xuben.hellobugben' 

# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Remove calculator package from device 

device. removePackage (package) 


























运行 结果 如 图 3-49 和 图 3-50 所 示 ( 印 载 前 如 图 3-49 所 示 ， 钊 载 后 如 图 3-50 所 示 ) , bugben ARRIER. 



































bugben SL4A Python for A 








图 3-49 ”运行 卸载 bugben 脚 本 前 





Python for Ai 











图 3-50 ”运行 卸载 bugben 脚 本 后 











monkeyrunner 应 用 操作 API 总 结 如 图 3-51 所 示 。 





MEE" as waitForConnection() 等 待 设 备 连 接 


installPackage() 安装 应 用 


MonkeyRunner MonkeyDevice 


API 





MRIS 


removePackage() Package 


Monkeylmage 
API 





图 3-51 monkeyrunner 应 用 操作 API 总 结 
3.2.6 ”monkeyrunner 设 置 控制 APl: 重启 、 唤 醒 、 获 取 设 备 属 性 
| TREES 也 不 懂 如 何 获得 设备 属性 。 另 外 ， 有 同事 问 ， 如 何在 运行 过 程 中 希望 唤醒 系统 ， 你 有 办 法 没 ? 


E 
CURE, HUNGER EAT 








设备 重启 、 唤 醒 和 获取 设备 等 操作 并 无 对 应 monkey 命 令 ， 对 应 的 monkeyrunner 的 API 如 图 3-52 所 示 。 











设备 重启 : 获取 设备 属性 : 

通过 MonkeyDevice 的 通过 MonkeyDevice 的 通过 MonkeyDevice 的 
reboot() 方 法 即 可 重启 设 getProperty() 或 wakel) 方 法 即 可 唤醒 设 
备 ， 并 在 重 局 后 选择 需 getSystemProperty() 方 法 


要 进入 的 模式 即 可 获取 设备 属性 





图 3-52 monkeyrunner 在 设备 重启 、 唤 醒 和 获取 设备 等 操作 上 对 应 的 API 


Se 
SH, RitiZ 40 44] uA 4! Bootloader RRecovery# AM? 





void reboot (string into) 





Q 重启 设备 并 进入 到 不 同 模式 。 

对 于 reboot， 我 们 需要 区 分 希望 进入 哪 种 模式 进行 操作 。 

参数 详细 说 明 如 下 。 

string into， 有 3 种 重启 选项 一 “bootloader” , "recovery" 和 “None” , 


Qi 


- 传 入 “bootloader”， 即 传说 中 的 Bootloader 重 启 ， 设 备 重启 后 进入 bootloadetr 环 境 。 





- 传 入 “recovery”， 即 传说 中 的 Recovetry 重 启 ， 设 备 重启 后 进入 recovery 环 境 。 


: 传 入 “None”， 即 传说 中 的 普通 重启 ， 设 备 重启 。 





脚本 样 例如 代码 清单 3-14 所 示 。 


代码 清单 3-14 Input monkeyrunner bugben.py 





# Usage: monkeyrunner drag monkeyrunner bugben.py 
# Import the monkeyrunner modules = 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
# Prepare start and end with 12 steps in 1.5s 
bootloader_reboot = 'bootloader' 

recovery reboot = 'recovery' 

simple reboot = 'None' 

# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Swipe from start to end 

device.reboot (recovery reboot) 

# device.reboot (bootloader reboot) 

# device. reboot (simple reboot) 











IR] 





手机 重启 后 进入 Recovery 模 式 ， 如 





3-53 所 示 。 





‘Android system recovery <3e> 


Volume up/down to 


move highlight: 


enter button to select. 


D 
= 


apply update from 
apply update from 
apply update from 
apply update from 
Wipe data/factory 


‘external storage 


internal storage 
ADB 

cache 

reset 


wipe cache partition 


backup & restore 
mount & storage 
advance 





脚本 样 例如 代码 清单 3-15 所 示 。 





代码 清单 3-15 wake monkeyrunner bugben.py 





# Usage: monkeyrunner wake monkeyrunner bugben.py 

# Import the monkeyrunner modules T 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Wake up the screen 

device.wake () 























其 实 ， 初 次 连接 时 设备 会 自动 唤醒 。 唤 醒 主 要 用 于 长 等 待 事件 后 的 操作 ， 这 里 只 是 举 个 简单 例子 。 





























3 .获取 当前 设备 属性 





object getProperty(string key) 


Giz 获取 当前 设备 属性 对 象 。 











对 于 getProperty() 方 法 ， 只 需要 传 入 其 属性 变量 名 即 可 (参见 附录 B) 。 





参数 详细 说 明 如 下 。 


string key， 提 供 系统 环境 变量 名 。 





返回 : 当前 设备 属性 对 象 。 





脚本 样 例如 代码 清单 3-16 所 示 。 


代码 清单 3-16 getProperty monkeyrunner bugben.py 





# Usage: monkeyrunner getProperty monkeyrunner bugben.py 

# Import the monkeyrunner modules — 7 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Swipe from start to end 

display = device.getProperty ('build.type') 

print display 





命令 行 显示 其 build 属 性 为 U。 eng’ ， 如 图 3-54 所 示 。 














D: \xuben \andro id-sdk-windows4.2\tools>monkeyrunner.bat getProperty_monke yrunner 


bugben . py 
weng’ 





图 3-54 build 属性 


Oi 


+ 此 处 引入 python 的 print0 元 数 以 便 在 命令 行 中 显示 打印 信息 。 


- 此 处 查看 的 是 build.type 属 性 ， 其 他 属性 查看 方式 参见 附录 B。 


4 获取 当前 设备 属性 





object getSystemProperty (string key) 


OQ. 获取 当前 设备 属性 对 象 ， 等 同 于 getPropetty(stringkey)。 

















对 于 getSystempProperty() 方 法 ， 只 需要 传 入 其 属性 变量 名 即 可 (参见 附录 B) 。 
参数 详细 说 明 如 下 。 


string key， 提 供 系统 环境 变量 名 ， 等 同 于 adb shell getprop<key>。 








返回 : 当前 设备 属性 对 象 。 


脚本 样 例如 代码 清单 3-17 所 示 。 





代码 清单 3-17 getSystemProperty monkeyrunner bugben.py 





# Usage: monkeyrunner getSystemProperty monkeyrunner bugben.py 
# Import the monkeyrunner modules a ~ 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Swipe from start to end 

display = device.getSystemProperty ('build.type') 

print display 








如 果 再 次 查询 其 build 属 性 ， 显 示 为 None， 如 











3-55 所 示 。 





[ 





D: \xuben Nandro id-sdk-windows4.2\tools>monkeyrunner.bat getSystemPropert y_monke yr 


unner_bugben. py 
None 





图 3-55 ”再 次 查询 build 属 性 





monkeyrunner 设 置 控制 API 总 结 如 图 3-56 所 示 。 











getProperty() 获取 当前 设备 属性 


getSystemProperty() 





MonkeyDevice 
API 


图 3-56 ”monkeyrunner 设 置 控制 API 总 结 
小 插曲 3: 传说 中 的 Bootloader、Recovery 和 Fastboot 到 底 是 什么 


额 ， 奔 哥 ， 就 算 知 道 进 什 么 模式 ， 进 去 后 我 总 得 清楚 自己 进去 要 干 嘛 吧 ? 





首先 是 BootLoader 模 式 ， 类 似 于 PC 的 BIOS 设 置 ， 在 操作 系统 内 核 运 行 之 前 进入 BootLoader 以 完成 整个 系统 的 加 载 启 动 任务 ， 进 入 BootLoader 后 可 对 系统 软 、 硬 件 环 境 进 行 设置 (如 初始 化 硬件 设 
备 、 建 立 内 存 空间 映射 图 等 ) 。 
































然后 是 Recovery 模 式 ， 就 是 传说 中 的 “工程 模式 ”， 那 些 喜 欢 刷 ROM 的 发 烧 友 们 对 这 个 模式 一 定 不 陌生 。 简 单 解释 一 下 图 3-53 所 示 的 选项 。 
+ reboot system now: 直接 重启 。 

- apply update from external storage: 通过 外 部 存储 卡 中 的 update 文 件 升级 。 

* apply update from internal storage: 通过 内 部 存储 卡 中 的 update 文 件 升级 。 

“ apply update from ADB: 直接 通过 ADB 方 式 升级 。 

- apply update from cache: 通过 缓存 中 的 update 文 件 升级 。 


* wipe data/factory reset: 清除 内 存 数 据 和 缓存 数据 。 





* wipe cache partition: 清除 缓存 分 区 。 
“ backup&erestore: 备份 并 还 原 。 
: mount&storage: 加 载 并 存储 。 


advance: 高 级 选项 。 





每 款 设备 弹出 的 Recovery 模 式 选项 各 不 相同 ， 但 大 同 小 异 ， 大 家 可 以 先 通过 Google 或 百度 查询 一 下 。 




















最 后 说 说 Fastboot， 它 不 属于 monkeyrunner 的 重启 模式 ， 但 如 果 需 要 深度 刷机 ( 非 简单 刷 ROM， 而 是 彻底 刷 系 统 ) ， 则 必须 使 用 Fastboot 进 行 线 刷 (通过 USB 连 接 进 行 刷机 ) 而 非 Recovery 的 卡 刷 
(通过 SD 卡 刷机 ) 。Fastboot 常 用 命令 如 下 。 


























// xuben: 查看 驱动 设备 

fastboot devices 

// xuben: 擦 除 XXX 

fastboot eraser XXX 

// xuben: 刷 XXX 版 本 ， 如 fastboot flash system system.img 
fastboot flash XXX XXX.img 

// xuben: 重启 设备 

fastboot reboot 


Er] | 
5% 哇 ， 这 下 彻底 明白 了 ! 


3.2/7 ”monkeyrunner 基 本 图 像 处 理 API: 截屏 、 图 像 保 存 


e. 跟 我 说 一 下 截屏 吧 ， 以 及 截屏 后 图 像 如 何 保存 ， 我 觉得 这 才 是 有 用 的 功能 呢 ! 


s» 
CUR, AAW! 


9o. 办 ，MonkeyImage 就 是 专门 做 这 事 儿 的 ! 





截屏 和 图 像 保存 操作 并 无 对 应 monkey 命 令 ，monkeyrunner 对 应 API 如 图 3-57 所 示 。 














通过 MonkeyDevice 的 
takeSnapshot () 方 法 即 可 
获 职 当前 屏幕 图 像 


E te tee: 

通过 Monkeylmage 的 
writeToFile() 方 法 即 可 将 截 
取 图 像 另存 为 图 片 





图 3-57 ”monkeyrunnet 在 截屏 和 图 像 保 存 等 操作 上 对 应 的 API 


呵呵， 想不到 如 此 简单 





1. 截 屏 





MonkeyImage takeSnapshot () 





Osz 捕获 当前 屏幕 。 








对 于 takeSnapshot， 无 需 传 参 ， 直 接 捕获 当前 屏幕 。 














Qa 仅仅 捕获 是 不 够 的 ， 还 需要 通过 wtiteTofile0 方 法 将 其 存 为 图 片 。 
脚本 样 例如 代码 清单 3-18 所 示 。 


代码 清单 3-18 takeSnapshot monkeyrunner bugben.py 





# Usage: monkeyrunner takeSnapshot monkeyrunner bugben.py 

# Import the monkeyrunner modules T 

from com.android.monkeyrunner import MonkeyRunner ,MonkeyDevice 
# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Get the snapshot 

picture = device.takeSnapshot () 








2. 图 像 保存 














void writeToFile(string path, string format) 





Giz 将 当前 图 像 存 为 图 片 文 件 。 
对 于 writeTofile， 需 要 提供 存储 全 路 径 以 及 文件 格式 。 
参数 详细 说 明 如 下 。 
“string path， 存 储 全 路 径 ， 包 括 文件 扩展 名 。 
“ string format， 存 储 格式 。 
Qi 
.如果 不 提供 存储 格式 ， 则 从 path 中 的 文件 扩展 名 中 推断 该 存储 格式 。 
. 如 果 既 没 提供 存储 格式 ， 在 path 中 也 不 包含 文件 扩展 名 ， 将 存 为 png 格 式 文件 。 


脚本 样 例如 代码 清单 3-19 所 示 。 





代码 清单 3-19 writeTofile monkeyrunner bugben.py 





# Usage: monkeyrunner writeToFile monkeyrunner bugben.py 

# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner ,MonkeyDevice, MonkeyImage 
# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Get the snapshot 

picture = device.takeSnapshot () 

# save this picture 

picture.writeToFile('./bugben pic.png', 'png') 











打开 当前 目录 下 的 bugben_pic.png 文 件 ， 如 图 3-58 所 示 。 











图 3-58 ”截屏 图 像 bugben_pic.png 

















monkeyrunner 基 本 图 像 处 理 API 总 结 如 图 3-59 所 示 。 














ir X: takeSnapshot() 


Mir cm writeToFile() 保存 图 像 文件 





3-59 ”monkeyrunner 基 本 图 像 处 理 API 总 结 


3.2.8 monkeyrunner 必 备 图 像 处 理 API: 图 像 截 取 、 对 比 


eo 


“保存 图 像 好 是 好 ， 但 更 多 的 情况 是 需要 将 两 张 图 片 放 在 一 起 来 对 比 两 者 是 否 完全 一 致 ， 这 才 是 测试 的 重点 。 另 外 ， 如 果 能 截取 图 像 中 的 某 一 块 ， 会 让 测试 人 员 更 省 心 ! 


人 额 ， 奔 哥 ， 能 做 到 吗 ? 


Orna, 不 就 是 图 像 的 截取 和 对 比 吗 ? 咱们 一 起 试 试 吧 ! 
































悦 像 截取 和 图 像 对 比 等 操作 并 无 对 应 monkey 命 令 ，monkeyrunner 对 应 API 如 图 3-60 所 示 。 


HARER: 图 你 对 比 : 

通过 Monkeylmage 的 通过 Monkeylmage 的 
getSublmagel() 方 法 即 可 sameAs() 方 法 即 可 对 两 
a RS By RS RTF 张 图 像 进 行 对 比 

图 像 








图 3-60 ”monkeyrunner 在 图 像 获取 和 图 像 对 比 等 操作 对 应 API 











fe 
全 呵呵， 看 上 去 很 简单 的 样子 ， 不 过 传 什么 参数 呢 ? 


1. 截 取 子 图 像 








MonkeyImage getSubImage (tuple rect) 





Oz He M BRP RAE DEB GSy ws b) HA HAR. 


























对 于 getSublmage( 方 法 ， 只 需要 将 其 左上 角 坐 标 和 所 要 截取 图 像 的 宽 、 高 组 合 为 一 个 tuple 型 变量 传 入 即 可 获取 该 图 像 的 子 图 像 。 
参数 详细 说 明 如 下 。 


tuple rect， 所 选 矩形 元 组 。 





返回 : 所 选区 域 图 像 。 











Qi 该 矩形 元 组 由 xy,w,h 组 成 ， 其 中 x 和 y 为 矩形 左上 角 坐 标点 ，w 为 矩形 宽度 ，h 为 矩形 高 度 。 
脚本 样 例如 代码 清单 3-20 所 示 。 


代码 清单 3-20 getSublmage monkeyrunner bugben.py 





# Usage: monkeyrunner getSubImage monkeyrunner bugben.py 
# Import the monkeyrunner modules 
from com.android.monkeyrunner import MonkeyRunner ,MonkeyDevice, MonkeyImage 


# Prepare x, y, w, h, rect 
x = 300 

y-50 

w = 200 

h = 250 

rect = (x, y, w, h) 


# Connect to the current device 

device = MonkeyRunner.waitForConnection () 
# Get the snapshot 

picture = device.takeSnapshot () 

# Get sub-picture 


subpic = picture.getSubImage (rect) 





oFil ‘SC ./bugben_pic.png', 'png') 
re 


tu 
subpic.writeToFile('./bugben subpic.png','png') 








bugben_pic.png 为 全 屏 图 像 ， 如 图 3-61 所 示 。bugben_subpic.pn 为 截取 的 子 图 像 ， 如 图 3-62 所 示 。 



































bugben Python for A 








Ezicsül E 











3-61 SAA 























加 








像 对 比 





boolean sameAs (MonkeyImage other, float percent) 


Gx 对 比 当 前 图 像 与 对 比 图 像 是 否 一 致 。 
































对 于 sameAs() 方 法 ， 不 仅 需要 传 入 要 对 比 的 图 像 ， 还 需要 传 入 两 张 图 像 匹配 的 百分比 。 
参数 详细 说 明 如 下 。 
- MonkeyImage other， 对 比 MonkeyImage 图 像 。 


- float percent， 匹 配 百 分 比 ， 范 围 为 0.0~1.0， 黑 认为 1.0， 即 必须 全 部 匹配 。 


图 3-62 


截取 子 图 像 





返回 : true 为 两 张 图 像 一 致 ，false 为 不 一 致 。 











脚本 样 例 如 代码 清单 3-21 所 示 。 





代码 清单 3-21 sameAs monkeyrunner bugben.py 


# Usage: monkeyrunner sameAs monkeyrunner bugben.py 
# Import the monkeyrunner modules > 

from com.android.monkeyrunner import MonkeyRunner ,MonkeyDevice,MonkeyImage 
# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Swipe from start to end 

picturel = device.takeSnapshot () 

picture2 = device.takeSnapshot () 

# compare two pictures 

compare = picturel.sameAs (picture2, 0.9) 

# Print picstr 

print compare 














命令 行 返回 为 True， 即 符合 匹配 要 求 ， 如 图 3-63 所 示 。 

















Oa 当 运行 sameAs0 方 法 时 报错 : 不 能 将 IChimpImage 对 象 转 换 为 IMonkeyImage 对 象 。 


图 像 对 比 结果 


出 现 这 个 错误 表示 monkeyrunner.jar 版 本 较 老 ， 下 载 最 新 版 本 替换 到 “android-sdk-WindowsX.X\tools\lib” 即 可 。 实 在 不 行 还 可 直接 通过 python 的 PIL 库 进行 图 像 比较 ， 也 可 达到 相同 的 效果 。 








monkeyrunner 必 备 图 像 AP| 总 结 如 图 3-64 所 示 。 




















sameAs() 


Monkeylmage 


getSublmage() 





图 3-64 ”monkeyrunner 必 备 图 像 API 总 结 


3.2.9 monkeyrunner 强 大 图 像 处 理 API: 转换 格式 、 获 取 像 素 元 组 /像素 值 


| CHEFS 看 来 如 果 我 希望 转换 图 像 格 式 ， 或 者 获取 图 像 像 素 元 组 或 像素 值 应 该 也 不 难 吧 ， 这 样 一 来 测试 人 员 就 方便 多 了 ! 


3 
A. 


SE, RAMA RRA KT? | 


e... 不 就 转 转 格 式 ， 获 取 一 下 像素 嘛 ， 如 果 monkeyrunner 不 支持 ， 咱 们 写 个 脚本 也 能 搞定 ， 就 是 麻烦 点 儿 ， 呵 呵 ! 











转换 格式 、 获 取 像 素 元 组 、 获 取 像 素 值 等 操作 并 无 对 应 monkey 命 令 ，monkeyrunner 对 应 API 如 








图 3-65 所 示 。 








获取 像素 值 : 

通过 Monkeylmage 的 
getRawPixelint() A 法 BN 
可 获取 该 点 像素 值 


转换 格式 : 

通过 Monkeylmage 的 
convertToBytes() 方 法 即 
可 将 当前 图 像 格式 转换 


获取 像素 元 组 : 

通过 Monkeylmage 的 
getRawPixel() 方 法 即 可 
获取 该 点 像素 元 组 


为 你 希望 的 图 像 格式 








3-65 ”monkeytrunnet 在 转换 格式 、 获 取 像 素 元 组 、 获 取 像 素 值 等 操作 对 应 API 














1. 转 换 图 像 格式 














string convertToBytes (string format) 








Oz 将 当前 图 像 转换 成 你 输入 的 图 像 格式 ， 黑 认为 png 格式 (Portable Network Graphics) o 

















对 于 convertToBytes() 方 法 ， 只 需要 传 入 希望 转换 的 图 像 格式 即 可 。 











参数 详细 说 明 如 下 。 


string format， 和 希望 输出 的 图 像 格式 。 








返回 : 图 像 二 进 制 数据 字符 串 。 





Qi 目前 支持 所 有 常用 光栅 图 像 格式 。 


脚本 样 例如 代码 清单 3-22 所 示 。 





代码 清单 3-22 convertToBytes monkeyrunner_bugben.py 





# Usage: monkeyrunner convertToBytes monkeyrunner bugben.py 
# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Get the snapshot 

picture - device.takeSnapshot () 

# convert to jpg 

picstr = picture.convertToBytes ('jpg') 

# Print picstr 

print picstr 














代码 清单 3-22 执 行 结果 为 一 大 堆 二 进 制 数据 ， 如 图 3-66 所 示 。 








如 此 一 来 ， 就 可 以 很 方便 地 进行 图 片 数据 传输 了 。 


2. 获 取 当 前 坐标 像素 元 组 





tuple getRawPixel(integer x, integer y) 





oe 获取 输入 坐标 下 的 单个 像素 整数 元 组 。 


对 于 getRawPixel( 方 法 ， 只 需要 传 入 需要 获取 像素 的 xy 坐标 即 可 。 
参数 详细 说 明 如 下 。 
+ integerx，x 坐 标 值 。 


' integery，y 坐 标 值 。 


. —96, -99, -119. -100. 110. -82. 20. 81, 69. 118. -80. 110. -73. -66. 49, 

-83, 13. -62, -106, -6, 26, -24, 44, 46. 12, -42, -30. 39, -58. -8. -58. 51. 

» 61, 107, -103, -74. -—71, -118. -26. 53, -111. 25, 88. 31. -72, 65, -56, 

1, 105, -99, 29, -98, 49, -119, 16. -14, 15, -91,. 94, -28,. 69, -123, 20. 81, 91. 
-27,. 3, 46. 13. 103. -35, -23, -8?, 50, -109, -125, -65, 25, 30, -11, 114, 9, 
66, —-45, @, -112, -19. 13, -36, 14, —43, -107, 119, -84, -115, 51, 92. 9, -87, 6 

4. -15. -40, 58, -115, -105. 104. 11, 46, 62, -115, -23, 77, 54, -117, 10, 46, 

-78. 100, 77. 66. -54, -14, 27, -19。58。85。 -114, 88. -14. -65,. -68. 76. -8 
-88, -11, -84, -53., -104, -39. -9, 44, -86. -37. -14, 88. —73. 98. 79. | 
» —96, -51, 105, 28, -22,. 36. 24. 106, 113, -107. 101. -24. 71, -75, 99, 

36, 105, 69, —-38. 121. 67, 7. -115. 35, 102. 101, 63, 121, 112. 43. 69, 52. -62. 
—63. 69. 20, 87, -97, —-36. -86, 64, -55, -26, -58, -49. 27, 113, -14. -?3, 53, 

-105, 66, 106. -73,. 76, 97, -34。 -48, -28. 109. 44, -72. 56, -85, 54, 22, -14, 

—92, 105, 8, -53, 18, 72. -10. -82, -81. 77, -46, 34. 88. 
» —%, -16, 34, -117. 95, 82. -1@9, -86, 81. 69, 21, -57, 127. 8. 
-18, 105, -127, -74, -100. -9, -82, -78。 -13, 69, -118, -1@, -26, 123, 167, 1 
-114. 13, 85. 26, -70,. -37. 1. -127, 58. 117. -54. -5, -41. 43. 36. 108. 14, 
» 126, 15, -104, 99, -95. -18. 42, 90, 40, 40, -94, -118, -73,. 111, 127, -28 

m Scot Bs IE Ney i eh bres EL ors kr red chbke Sb Cis pede GENS reh kri 

32, 37. -?7. -49. 111. -50. -99, -68. -123, 3, 60. -6, 122, 83, 82. 104, 44, 20. 
81, 69, 117, 4, -62。 -64, -69, 54. B. -2, 85. 20, 118, -61, -4?. 23. 62, 96, 41 

» —4, 35, 29, 63, -58. —79, -32, -66. -1608. 43. 41. —-7. -112,. -114, -104. —49, 6 

"PELLE 98, —42, 87, -114, -36, -126, -59, -2, 98. 70, 123, 85. -13, 38. 43, 5, 

20. 81. 90, 81. 91, 49, -72, 105, 72. 66, -66, -67, -22, 89, 45, 99, -112. -27. 

u^ 19, -24, 79, 21, -101, -55, -68, 73, -68, -20, 86, 70, 25, 49, E 

> 96, 46, 0. 96, 73. -90. -84. 1. 69, 20, 86. 109. -42. -118, -103. -34, 

4. 61, 70. 56, -84, -101. -67. 48. -61,. -56, 109, -53, -24, 7. 38, -78, -91, 

» -115, -2, 86. 76, 7. -89, 52, -81, 2, 57, 38. 61, -89, 61. -120, -87, 112, 79. 
97, -36. 40. -94. -118, -3@, -42, 9, 66. 16, 50, -86, -35, 71. -83. 58, 56, 74, 
Sey rbi Sor lye) SU Ben dda Ga SURE Shs see etel eid 

» 36, 8, -32, -111, -181. -66. 14. B. -6. —44, 114. 88. 119, 16, 40. -94, -8 

CUB EIR REM te eR LR) Sora ds Se 74; 734: -383 GI: 92: 93 SJs So iver) 44; 

—-97, 274, -117, -26. -124, -58. 16. 39. 61, 114, 15, -13, -51. 46, 81, -123, 
. —31, 88. 56, 85, -55. 98. 120. 86, 50. 105. -49, 26, -112. -66. -55, 
—-94, -116, 38, -12, 117, -59. 105, -121, -68. -77. 127. 62, -40, 35. 74. 59, 99 
-7a 81. 121, 117, -88, -34, -94,. -101, -25. 27. 51, -14, -126, 57, -91. 96. 10 
46, -94, -78。-56。 -29, -116, 26, -119, -44, -12, -85, 169, 22, 50. 5. 76, 80, 
125, 74. -64. 28, Si. 69. 84, 43. -118. 9. -19. 73. -114. 106. -61. -58. 71. 5 

7, (8, 13. 66, -54, 69, 33. -123, 26, 81. 94. -32. —94, -98, 5, 51. -52., 69, —-5, 
—52. 0. -35, -73. 36. -9,. -12. -87, 113. -51. 102, 113. -123, 20, 81. 72. 58. 

11. -26, -99, 72. 26, 6, 45, -127. -109, -44, -45, -88, 8, -94, -118. 40, -94, 

116. 82, —46, U,. -94,. -118. 41, 41, 113, 76. -105, —51, 27. 76, 74. 27, 

» 6, -110, 88, -52, -119, 24, 44, -56, -64, -122, -54, 118. 63, -31,. 64, -62, 

18, 46, -89. -19. -?, -73, 100, -29, 24. -5S?. 46, -59, -33, -69, 31. 55. 76, 

» 26, 121, 104, 23, 113, 111, 115, -42, -100, 112, 1. 36, —-32, 14. 114. 104, Ø, 


图 3-66 ”将 图 像 转换 为 二 进 制 
返回 : tuple 型 ( 即 (a,r,g,b) 形 式 ) 的 整数 元 组 。 
Qi 
“ a 表示 所 有 颜色 之 支持 设置 透明 度 。 
+ gba RRA (ted) 、 绿 (green) 、 蓝 (blue) 三 原色 。 


脚本 样 例如 代码 清单 3-23 所 示 。 





代码 清单 3-23  getRawPixel monkeyrunner bugben.py 





# Usage: monkeyrunner getRawPixel monkeyrunner bugben.py 
# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice,MonkeyImage 
# Prepare x, y 

x = 45 

y = 185 

# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Get the snapshot 

picture = device.takeSnapshot () 

# Get the pixel 

pixel = picture.getRawPixel (x, y) 

# Print pixel 

print pixel 














坐标 像素 元 组 显示 ， 如 图 3-67 所 示 。 











D:NxubenNvandroid-sdk-windows4.2\tools >monkeyrunner.bat getRawPixe1l_monkeyrunner 


bugben .py 
(-1,. 135, 124, 98) 





图 3-67 ”坐标 像素 元 组 





素 元 组 和 像素 值 有 什么 区 别 ? 


3. 获 取 输 入 坐标 像素 值 





integer getRawPixelInt(integer x, integer y) 


[o 获取 输入 坐标 下 的 单个 像素 值 。 





对 于 getRawPixelint() 方 法 ， 只 需要 传 入 需要 获取 像素 的 xy 坐标 即 可 。 
参数 详细 说 明 如 下 。 


' integerx，x 坐 标 值 。 





' integery，y 坐 标 值 。 
返回 : 32 位 像素 值 。 
Qi 该 32 位 像素 值 为 abg&b， 每 个 占 8 位 ， 从 左 至 右 依次 组 成 。 


脚本 样 例如 代码 清单 3-24 所 示 。 





代码 清单 3-24 getRawPixelint monkeyrunner bugben.py 





# Usage: monkeyrunner getRawPixelInt monkeyrunner bugben.py 
# Import the monkeyrunner modules ` 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice,MonkeyImage 
# Prepare x, y 

x = 45 

y = 185 

# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Get the snapshot 

picture = device.takeSnapshot () 

# Get the pixel 

pixel = picture.getRawPixelInt(x, y) 

# Print picstr 

print pixel 








输出 如 图 3-68 所 示 。 











D: \xuben \Nandro id-sdk-windows4.2\tools>monkeyrunner.bat getRauPixellnt monkeyrunn 


er bugben.py 
-7898014 














图 3-68 ”获取 输入 坐标 像素 值 











monkeyrunner 强 大 图 像 处理 AP| 总 结 ， 如 图 3-69 所 示 。 




















convertToBytes() 转换 图 像 格 式 





Monkeylmage getRawPixel() en 





获取 当前 坐标 像 


getRawPixelint() 素 信 


图 3-69 ”monkeyrunner 强 大 图 像 处 理 API 总 结 


3.240 monkeyrunneri&gAPI: 广播 、 用 例 及 命令 


eo, 做 得 不 借 ! 不 过 现在 完成 的 只 是 冰山 一 角 罢 了 ， 我 们 还 有 大 量 的 命令 需要 执行 ， 有 大 量 的 脚本 需要 运行 ， 有 大 量 的 广播 需要 发 送 ， 这 些 才 是 整个 冰山 ， 能 做 到 吗 ? 


人 
TOR? 我 看 是 火炮 山 还 差不多 …… 


[= 只 有 做 到 命令 执行 、 脚 本 运行 、 广 播发 送 ，monkeyrunner 才 能 在 他 老 爸 面前 证 明 他 真正 的 实力 ! 














广播 、 用 例 及 命令 并 无 对 应 monkey 命 令 ，monkeyrunner 对 应 API 如 图 3-70 所 示 。 


命令 : 

通 过 MonkeyDevice 的 通 过 MonkeyDevice 的 通 过 MonkeyDevice 的 
shell() 方 法 即 可 直接 在 设 broadcastlntent() 方 法 即 可 instrument() 方 法 即 可 直接 
备 端 执行 命令 直接 发 送 广 播 给 设备 在 设备 端 运行 用 例 





图 3-70 ”monkeyrunner 在 广播 、 用 例 及 命令 等 操作 对 应 API 


s» 
TUR Edab dag, BNA AR Rote LP SAGE SE X m? 


1. 发 送 广播 





void broadcastIntent(string uri, string action, string data, string mimetype, iterable categories, dictionary extras, component component, iterable flags) 





Qs 模拟 应 用 程序 将 Intent 广 播 给 设备 。 
参数 详细 说 明 如 下 。 
“ string uri， 设 置 Intent 的 URI， 参 见 Intent.setData0。 
+ string action， 设 置 Intent 的 Action， 参 见 Intent.setAction()。 
string data， 设 置 Intent 的 Data， 参 见 Intent.setData() 。 
+ string mimetype， 设 置 Intent 的 MIME type, #JUIntent.setType(. 
- iterable categories， 设 置 Intent 的 Categories， 参 见 Intent.addCategory()。 
* dictionary extras ， 设 置 Intent 的 extra data， 参 见 Intent.putExtra()。 
* component component， 设 置 Intent 的 ComponentName。 


- iterable flags， 设 置 Intent 的 flags ， 参 见 Intent.setFlags()。 











2. 运 行 测试 用 例 











dictionary instrument (string className, dictionary args) 


OQ... 3i it Android Instrumentationi& 448 X Android' s test case 类 中 的 测试 用 例 。 
对 于 instrument， 需 要 传 入 待 测 Instrumentation 的 用 例 类 名 和 包 名 ， 还 需 提供 Instrumentation 的 testrunner (3flandroid.test.InstrumentationTestRunner) , 
参数 详细 说 明 如 下 。 

+ string className，Android 组 件 名 ， 包 名 与 类 名 都 必须 完整 提供 。 

* dictionary args， 提 供 dictionary 型 标识 (flag) 及 其 值 ， 若 标识 无 值 则 值 为 空 字 串 。 


返回 : dictionary 型 的 component 输 出 。 


注意 className 中 传 入 的 组 件 必须 存在 于 当前 设备 中 。 














通过 如 下 命令 ， 列 出 当前 设备 中 可 运行 的 Instrumentation 用 例 。 











$adb shell 
# pm list Instrumentation 





运行 结果 如 图 3-71 所 示 。 











D:\xuben \too ls \Wwork\NCTS \android-sdk-windows4.2\tools> adb shell 

adb server is out of date. killing... 

* daemon started successfully 关 

root@kiton:/ # pm list instrumentation 

pm list instrumentation 

instrumentation:com. lenovo. leos.cloud.sync/android.test .Instrumentat ionTest Runne 


r (target=com. lenovo. leos.cloud.sync> 

instrumentat ion:com.xuben.hellobughben.test/android.test .Instrumentat ionTestRunne 
r Ctarget-com.xuben -hellobughen>) 
instrumentation:com.xuben.hellobughben2.test/android.test .InstrumentationTestRun 
er (target =com.xuben.hellobughben2> 

root@kiton:/ # 





图 3-71 运行 测试 用 例 


Qiu 这 里 列 出 的 用 例 为 巴 哥 奔 之 前 运行 过 的 Instrumentation 用 例 ， 若 你 没有 运行 过 ， 是 不 会 出 现 的 。 


脚本 样 例如 代码 清单 3-25 所 示 。 





代码 清单 3-25 instru monkeyrunner bugben.py 


# Usage: monkeyrunner instru monkeyrunner bugben.py 

# Import the monkeyrunner modules T 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 

# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Run Instrumentation case 

dict = device.instrument ('com.xuben.hellobugben.test/android.test. 
InstrumentationTestRunner') 

print dict 





运行 过 程 截图 ， 如 图 3-72 所 示 。 




















请 在 下 框 中 输入 希望 修改 的 文字 : 


* 本 框 1 文字 : ea 


CASTE THER (or 
本 框 1 粗细 ( e) 加 粗 Q E SII 


| i F= ^N ja m. | = 
oy /| VE US AS 








图 3-72  ifiidmonkeyrunneri& 4F Instrumentation Jf] 4] 





8 
R 
a 


打印 如 图 3-73 所 示 。 








f 





D: \xuben \tools \Wwork\NCTS \android—-sdk—-windows4.2\tools >monke yrunner.bat instru_mon 
ke yrunner_bugben. py 


<’stream’: 'wr*nTest results for InstrumentationTestRunner=.\r\nTime: @.912\¥\n 
r*nOK <i test>’> 














3-73 itmonkeyrunnerié 47 Instrumentation Jf] 45] 25 RK 





该 脚本 相当 于 在 命令 行 运行 如 下 命令 。 
am instrument -w -r -e class com.xuben.hellobugben.test/android.test.InstrumentationTestRunner 


而 这 里 运行 的 Instrumentation 脚 本 ( 即 com.xuben.hellobugben.test 测 试 项 目下 的 脚本 ) 将 在 Instrumentation 章 中 详 述 该 项 目 相关 脚本 。 








object shell(string cmd)) 


o. 在 monkeytrunnet 中 执行 shell 命 令 。 


对 于 shell， 只 需要 输入 希望 执行 的 shell 命 令 即 可 。 




















以 之 前 列 出 当前 设备 中 可 运行 的 Instrumentation 用 例 为 例 ， 代 码 如 下 所 示 。 


$ adb shell 
# pm list Instrumentation 











这 里 ， 可 以 直接 在 脚本 里 输入 。 


脚本 样 例如 代码 清单 3-26 所 示 。 





代码 清单 3-26 shell monkeyrunner bugben.py 


# Usage: monkeyrunner shell monkeyrunner bugben.py 

# Import the monkeyrunner modules ~ 

from com.android.monkeyrunner import MonkeyRunner, MonkeyDevice 
# Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Run shell 

instru = device.shell('pm list Instrumentation') 

print instru 





我 们 发 现 ， 运 行 出 现 问题 : “LookupError:unknown encoding gbk” ， 如 图 3-74 所 示 。 











D=:\xuben\too ls Wwork\CTS \android-sdk-windows4.2\tools >monkeyrunner.bat shell_monk 
eyrunner_bugben. py 

141268 18:07:16.159:S [main] [com.android.monkeyrunner.MonkeyRunnerOptions] Scri 
pt terminated due to an exception 

141268 18:67:16.159:S [main] [com.android.monkeyrunner.MonkeyRunnerOpt ions ITrace 


back (most recent call last): 
File "D:\xuben\tools \Wwork\cTS \android-sdk-windows4.2\tools\shell_monkeyrunner 
bughben .py"。 line 11, in <module> 
print instru 
LookupError: unknown encoding gbk 





图 3-74 运行 shell 报 错 


e» 
TUA SARI? 难道 是 脚本 出 错 ? 


QU, sn. 这 是 因为 monkeyrunner 是 调用 JPython 来 运行 的 ， 而 JPython 与 系统 默认 的 编码 方式 有 冲突 。 


打开 monkeyrunner.bat， 找 到 如 下 脚本 。 





call $java exe$ -Xmx512m -Djava.ext.dirs-$frameworkdir$;$swt path$ -Dcom.android.monkeyrunner.bindir=http://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/t 








将 其 改 为 如 下 脚本 。 





call $java exe$ -Xmx512m -Djava.ext.dirs-$frameworkdir$;$swt path$ -Dcom.android.monkeyrunner .bindir=http://www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/u 





保存 后 再 次 运行 ， 如 图 3-75 所 示 。 





D: \xuben \tools \Wwork\CTS \android-sdk-windows4.2\tools >monkeyrunner.bat shell_monk 


eyrunner_bughen. py 
instrumentation:com.lenovo.leos.cloud.sync/android.test .Instrumentat ionTestRunne 


> €target=com. lenovo. leos.cloud.sync> 


instrumentation:com.xuben.hellobughen.test/android.test.InstrumentationTestRunne 


r (target =com.xuben.hellobughben> 
instrumentation:com.xuben.hellobugben2.test/android.test.InstrumentationTestRunn 


er Ctarget=com.xuben .hellobugben2> 








图 3-75 运行 shell 脚 本 











哈哈， 运行 成 功 ! 


monkeyrunner 超 级 AP| 总 结 ， 如 图 3-76 所 示 。 





broadcastintent() 


MonkeyDevice API 





图 3-76  monkeyrunnerz& ZR APLÉ. 25 
3.2.11 monkeyrunner 帮 助 文档 
es 能 不 能 直接 给 大 家 弄 个 帮助 文档 ， 方 便 查阅 ? 
-人 % 奔 可 ， 这 繁重 的 工作 就 交 给 我 吧 ! 


B® <n, monkeyrunner 自 带 帮助 文档 ， 非 常 详实 丰富 ， 大 家 自行 下 载 查阅 吧 ! 





获取 帮助 文档 并 无 对 应 monkey 命 令 (这 是 由 于 monkey 所 需 的 帮助 非常 简单 ， 只 需 -h 命 令 在 命令 行 直接 获取 usage 即 可 ) ，monkeyrunner 对 应 API 如 图 3-77 所 示 。 


帮助 文档 : 

通过 MonkeyRunner 的 
help () 方 法 即 可 在 PC ii 
生成 MonkeyRunner 的 
API 帮助 文档 








图 3-77 monkeyrunner 获 取 帮 助 文档 对 应 API 


令 %wj 呵 ， 这 还 变 方 便 的 ， 不 用 每 次 都 去 找 那 个 网 页 了 ! 


monkeyrunner APl 帮 助 文档 





void help (string format) 





Oez 输出 Monkeyrunner API Reference. 
对 于 help， 只 需要 传 入 需要 的 文档 格式 (文本 文档 还 是 网 页 文档 ) 。 
参数 详细 说 明 如 下 。 

string format， 指 定 输出 格式 。 

Qi 

+ 指定 “text” 即 输出 text 文 档 。 

“ 指定 “html” 即 输出 HTMIL 文 档 。 

脚本 样 例如 代码 清单 3-27 所 示 。 


代码 清单 3-27 help monkeyrunner bugben.py 





# Usage: monkeyrunner help monkeyrunner bugben.py 
# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner 
# Prepare txt and html format 

txt format = 'text' 

html format = 'html' 

# Prepare monkeyrunner help 
MonkeyRunner.help(txt format) 

MonkeyRunner. help (html format) 





E 
TCR, MAT! 什么 都 没有 ! 无 论 是 当前 目录 还 是 其 他 目录 都 寻 它 不 着 ， 难 道 方法 错 了 ? 


99, un, 错 的 是 使 用 的 人 ， 这 样 写 试 试 ! 
修改 脚本 如 代码 清单 3-28 所 示 。 


代码 清单 3-28 ”修正 版 help_monkeyrunner_bugben.py 





# Usage: monkeyrunner help monkeyrunner bugben.py 

# Import the monkeyrunner modules 

from com.android.monkeyrunner import MonkeyRunner 

# Prepare txt and html format 

txt format = 'text' 

html format = 'html' 

# Prepare monkeyrunner help 

monkeyrunner helptxt = MonkeyRunner.help(txt format) 
monkeyrunner helphtml = MonkeyRunner.help (html format) 
* Generate monkeyrunner help.txt B 
mrhelp = open('monkeyrunner help.txt', 
mrhelp.write (monkeyrunner helptxt) i 
mrhelp.close(); T 

# Generate monkeyrunner help.html 
mrhelp = open('monkeyrunner help.html', 'w'); 
mrhelp.write (monkeyrunner helphtml); 
mrhelp.close(); B 


wt); 





Be 
SARAT! 这 是 为 什么 呢 ? 


20, 为 之 前 只 是 生成 了 数据 流 ， 并 没有 将 数据 流 保存 为 对 应 的 文本 或 网 页 文件 。 


在 脚本 当前 目录 你 会 发 现 如 图 3-78 所 示 。 


T W " 





monkeyrunner help.html monkeyrunner_help.txt 


图 3-78 ”生成 两 种 格式 的 帮助 文档 
打开 后 内 容 分 别 如 下 。 


1) HTML 格 式 帮 助 文档 : monkeyrunner_help.html， 如 图 3-79 所 示 。 





! Mozilla Firefox 


XE) ME BEV) 历史 (S) BEE) LAT) E) 


{ 1file:///D:/xuben/an...eyrunner. help.html BE - 
© @ file:///D:/xuben/android-sdk-windows4.2/tools/monkeyrunner. help.html 


pu pen 








MonkeyRunner Help 
Table of Contents 


com. android. monkeyrunner. MonkeyRunner. alert 

com. android. monkeyrunner. MonkeyDevice. broadcastIntent 
com. android. monkeyrunner. MonkeyRunner. choice 

com. android. monkeyrunner. MonkeyImage. convertToBytes 
com. android. monkeyrunner. MonkeyDevice. drag 

com. android. monkeyrunner. MonkeyView. getAccessibilitylds 
com. android. monkeyrunner. MonkeyRect. getCenter 

com. android. monkeyrunner. MonkeyView. getChecked 

com. android. monkeyrunner. MonkeyView. getChildren 

com. android. monkeyrunner. MonkeyView. getEnabled 

com. android. monkeyrunner. MonkeyView. getFocused 

com. android. monkeyrunner. MonkeyRect. getHeight 

com. android. monkeyrunner. MonkeyDevice. getHierarchyViewer 
com. android. monkeyrunner. MonkeyView. getLocation 

com. android. monkeyrunner. MonkeyView. getParent 

com. android. monkeyrunner. MonkeyDevice. getProperty 
com. android. monkeyrunner. MonkeyDevice. getPropertyList 
com. android. monkeyrunner. MonkeyImage. getRawPixel 

com. android. monkeyrunner. MonkeyI mage. getRawPixellnt 
com. android. monkeyrunner. MonkeyDevice. getRootView 
com. android. monkeyrunner. MonkeyView. getSelected 

com. android. monkeyrunner. MonkeyImage. getSubImage 


com. android. monkeyrunner. MonkeyDevice. getSystemProperty 
com. android. monkeyrunner. MonkeyView. getText 


图 3-79  monkeyrunner help.html 





2) TXT 格 式 帮 助 文档 : monkeyrunner_help.txt， 如 图 3-80 所 示 。 











B pean DOE E 记 住 了 ! 








© 意 在 源码 “AndroidX.X.X\sdk\monkeyrunner\scripts” 中 提供 了 更 全 面 的 生成 monkeyrunner 文 档 的 脚本 : help.py， 贴 出 来 供 感 兴趣 的 同学 参考 ， 如 代码 清单 3-29 所 示 。 


代码 清单 3-29 help.py 





图 3-80 monkeyrunnet_help.txt 








# !/usr/bin/env monkeyrunner 


# Copyright 2010, The Android Open Source Project 


# Licensed under the Apache License, Version 2.0 (the "License"); 
# you may not use this file except in compliance with the License. 


# You may obtain a copy of the License at 


http: //www.apache.org/licenses/LICENSE-2.0 


EGRE 


# Unless required by applicable law or agreed to in writing, software 
# distributed under the License is distributed on an "AS IS" BASIS, 


# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 


# See the License for the specific language governing permissions and 


# limitations under the License. 


from com.android.monkeyrunner import MonkeyRunner as mr 


import os 

import sys 

supported formats = ['html', 'text', 'sdk-docs'] 
if len(sys.argv) != 3: 

print 'help.py: format output" 

sys.exit(1) 

(format, saveto path) = sys.argv[1:] 

if not format.lower() in supported formats: 


print 'format $s is not a supported format' $ format 


sys.exit (2) 
output = mr.help(format-format) 
if not output: 

print 'Error generating help format" 
sys.exit (3) 

dirname = os.path.dirname (saveto path) 
try: 

os.makedirs (dirname) 

except: 

print 'oops' 

pass # It already existed 

fp - open(saveto path, 'w') 

fp.write (output) 

fp.close() 

sys.exit (0) 





monkeyrunner 帮 助 文档 API| 总 结 ， 如 图 3-81 所 示 。 


MonkeyRunner 


API 





MonkeyDevice 


MonkeyRunner API 





Monkeylmage 


API 


图 3-81 monkeyrunner 帮 助 文档 API 总 结 


3.3 monkeyrunner 脚 本 编写 
3.3.1 bugben 示 例 脚 本 剖析 


eo, uen 关 API 都 学 完了 ， 现 在 看 本 章 开 始 的 那个 脚本 没有 问题 了 吧 ? 


" 
全 区 奔 哥 ， 你 详细 讲 讲 吧 ， 不 然 消 化 不 了 ! 


$9o,... 那 我 就 加 上 详细 注释 吧 ! 

学 完 所 有 必 备 API 后 ， 下 面 我 们 再 来 一 起 看 看 本 节 开 始 的 那个 脚本 ， 如 代码 清单 3-30 所 示 。 

代码 清单 3-30 ”详细 解读 的 示例 脚本 

This is a monkeyrunner script created by BugBen 


This script will test the bugben.apk 
See http://developer.android.com/tools/help/MonkeyRunner.html 


Se db db db db 


Usage: monkeyrunner TestMonkeyRunner Demo.py 


# Import monkeyrunner modules 
import sys 


from com.android.monkeyrunner import MonkeyRunner, 


# Parameters 


txtl x = 327 
txtl y = 231 
txt2 x = 327 
Ext2 y = 375 
bold x = 500 
bold y = 600 
small x = 327 
small y = 744 
submit x 555 


submit y — 999 


type — 'DOWN AND UP' 
seconds = 1 

txtl msg = 'bugben 
txt2 msg = 'bugben 


package = 'com.xuben.hellobugben' 
activity = '.ChangeActivity' 
component = package + '/' 


# Connect device 


device 


# Install HelloBugben.apk 


device.installPackage('./HelloBugben.apk' 


print 


# Launch bugben 


device.startActivity (component) 


print 'Launching bugben...' 
# Wait 1s 
MonkeyRunner.sleep (seconds) 


# Input txtl 
device.touch(txtl x, 
device.type(txtl msg) 
device.press('KEYCODE ENTER' 
print 'rnputrng txtl;:s..' 


txtl y, 


# Input txt2 
device.touch(txt2 x, 
device.type(txt2 msg) 
device.press('KEYCODE ENTER' 
print '"Inputrng txt2..."' 


txt2 y, 


# Select bold 


device.touch(bold x, bold y, 








+ activity 


MonkeyRunner.waitForConnection() 


‘Installing HelloBugben.apk...' 


MonkeyDevice, MonkeyImage 


直接 从 1lib 库 中 导入 sys， 以 及 从 com. 


android.monkeyrunner 中 导入 MonkeyRunner, 


MonkeyDevice 和 MonkeyImag, 这 3 个 模块 
组 合 而 成 MonkeyRunner 这 款 强大 的 工具 


界面 各 控件 坐标 





按键 事件 


# Package name and activity name 


\ 《应 用 启动 所 需 包 名 和 应 用 名 


pipe 等 待 设备 连接 


) } 《一 从 当前 日 录 安 装 HelloBugben.apk 


ee 





t ) 
"m 输入 文本 框 1 信息 


k= 


type) 


,'DOWN AND UP') 


,'DOWN AND UP') 


type) 


print 'Selecting bold...' 


# Select small 
device.touch(small_x, small_y, type 


jd 





print 'Selecting small..." 


# Wait 1s 
MonkeyRunner.sleep(seconds) 


# Submit 
device.touch(submit x, submit y, type) 
print 'Submitting...' 


# Wait 1s 
MonkeyRunner.sleep(seconds) 


# Get the snapshot 
picture = device.takeSnapshot() 


截图 保存 为 bugben_pic.png 


picture.writeToFile('./bugben pic.png','png') 
print 'Complete! See bugben pic.png in current folder' 


# Back to home E $ 
device.press('KEYCODE HOME','DOWN AND UP') 


print 'Back to HOME.' 


(o 在 原理 篇 中 我 们 还 将 看 到 类 似 肢 本， 届时 我 们 将 逐一 分 析 每 行 monkeyrunner 语 句 的 原理 。 


3.3.2 monkeyrunner 脚 本 运行 注意 事项 








在 命令 行 运行 monkeyrunner.bat 时 ， 有 的 同学 发 现 运行 出 错 ， 如 图 3-82 所 示 。 











D:\xuben\tools \work\CTS \android-sdk-windows4.2\tools >monke yrunner. bat 
Exception in thread "main" java.lang.NoClassDefFoundError: com/android/chimpchat 
/ChimpChat 

at com.android.monke yrunner.MonkeyRunnerStarter.<init >(MonkeyRunnerStart 
er. java:6@>) 

at com.android.monkeyrunner.MonkeyRunnerStarter.main<MonkeyRunnerStarter 
.-java:188) 
Caused by: java.lang.ClassNotFoundException: com.android.chimpchat .ChimpChat 

at java.net .URLClassLoader$1.run<Unknown Source») 

at java.net .URLClassLoader$1.runCUnknown Source») 

at java.security.AccessController.doPrivileged(Native Method> 

at java.net .URLClassLoader.findClass(Unknown Source») 

at java.lang.ClassLoader.loadClass<Unknown Source») 

at java.lang.ClassLoader.loadClass(Unknown Source») 

--- 2 more 





图 3-82 ”运行 脚本 报错 


s» 


Sk FM, sod T, RAE! 


eo 别 抓 狂 ， 这 里 提 到 ChimpChat， 说 明 SDK 中 缺少 ChimpChatjar 这 个 包 。 
具体 步骤 如 下 。 


1) 首先 ， 到 Android 官 网 上 去 下 载 最 新 的 aster.zip， 链 接地 址 为 : http://code.google.com/p/aster/downloads/list, 





2) 其 次 ， 解 压缩 aster.zip， 找 到 chimpchat,jar， 位 置 为 “astemdistNarmchimpchatjar” . 





3) 将 chimpchat.jar 拷 贝 到 本 机 “~\android-sdk-WindowsX.X\tools\lib” 目 录 下 。 





4) 重新 运行 monkeyrunner.bat。 


结果 如 图 3-83 所 示 ， 一 切 正常 ! 





D: \xuben \too ls \WworkNCTS \android-sdk-windows4.2\tools >monke yrunner. bat 
Jython 2.5.6 (Release_2_5 6:6476. Jun 16 2069, 13:33:26> 


[Java HotSpot<TM> Client UM (Oracle EL 
o dh dalek 














5-83 运行 脚本 正常 





s» 
这 个 asterzip 是 什么 东西 呢 ? 


全曲 Android 系统 测试 运行 环境 的 缩写 。 缺 少 这 个 运行 环境 ， 包 括 monkeyrunnet 在 内 的 很 多 自动 化 脚本 都 运行 不 起 来 。 


3.4 第 三 个 Impossible Mission 
665, ons. 不 过 大 家 更 喜欢 录制 回放 的 功能 。 
i 
-人 录制 回放 ? 我 的 天 啊 ! 


$9. ia, 虽然 monkeyrunner 的 录制 回放 不 算 稳定 ， 不 过 应 付 一 些小 case 完 全 没 问 题 。 


3.5 ”monkeyrunner 的 录制 回放 


源码 “~\sdk\monkeyrunner\scripts” 下 有 monkey recorder.pyfflmonkey playback.py. 


将 这 两 个 文件 拷贝 到 SDK 的 tools 目 录 下 (Windows 目 录 为 “android-sdk-Windows\tools" 





”，linux 目 录 为 “android-sdks/tools”) ， 即 可 通过 如 下 代码 进行 运行 。 





monkeyrunner monkey recorder.py 





运行 结果 如 图 3-84 所 示 。 









加 


| 


Refresh Display | 


Export Actions 








MonkeyRecorder 


Press a Button | Type Something | Fling 





Wait 








WPS Office 











图 3-84 monkeyrunnet 脚 本 录制 界面 


3.5.1 ”等 待 功能 Wait 














第 一 个 选项 是 等 待 功能 (Wait) ， 点 击 后 弹出 输入 框 (以 秒 为 单位 ) ， 比 如 我 们 这 里 输入 3， 即 为 3s， 如 图 3-85 所 示 。 














输入 后 点 击 “ 确 定 ” 按 钮 ， 右 侧 显 示 命 令 如 图 3-86 所 示 。 











该 命令 导出 后 如 下 所 示 。 


WAIT|('seconds':3.0,] 





对 应 接口 为 nonkeyrunner 的 sleep() 方 法 ， 如 下 。 


void sleep(float seconds) 


对 应 脚本 为 如 下 代码 。 


MonkeyRunner. sleep (seconds) 











J MonkeyRecorder 


ok | tn | Type stained HN Export Actions Refresh — 






WPS Office 


How many seconds to wait? 


prem aes Sew 
Q 








图 3-85 等待 功 能 





FA MonkeyRecorder 


Wat | Press a Buton Type Something y | Fins | Export Actions Refresh Display 
E 


Wait for 3.00000 seconds 


bugben SLAA WPS Office 


| 
区 














图 3-86 等 待命 令 


3.5.2 ”按键 功能 Press a Button 








第 二 个 选项 为 按键 功能 (Press a Button) ， 按 键 分 为 菜单 键 (MENU) 、 主 页 键 (HOME) 和 搜索 键 (SEARCH) ， 很 奇怪 没有 后 退 键 。 

















而 对 应 的 动作 分 为 按键 (Press) ， 按 下 (DOWM) 和 抬 起 (UP) ， 这 也 是 一 个 奇怪 的 组 合 ， 如 图 3-87 所 示 。 














—— 


| PressaButton | a Button 
nn Dod E 


ao 


bugben SLAA WPS Office 













zT. 
€». Lf 
Ix 






ws 








Wait for 3.00000 seconds 
Tap touchscreen at (1434, 1284) 


pt xi 





eae [Home 


SEARCH 


[2 | What button to press? MEN| sl 

















图 3-87 按键 功能 





这 里 我 们 选择 “HOME” 和 “Press”， 右 侧 脚本 如 图 3-88 所 示 。 

















该 命令 导出 后 如 下 。 


PRESS | { 'name' : 'HOME', 'type':'downAndUp',] 


对 应 接口 为 nonkeyrunner 的 press() 方 法 ， 如 下 。 





void press(string name, dictionary type) 


对 应 脚本 如 代码 3-31 所 示 。 


代码 清单 3-31 ”按键 对 应 脚本 





# Prepare keycode and type 

name — 'KEYCODE HOME' 

type = 'DOWN AND UP' 

# Connect to the current device 

device = MonkeyRunner.waitForConnection () 
# Swipe from start to end 

device.press (name, type) 











EA MonkeyRecorder = | 口 | x| 
Type Something | Ring | Export Actions Refresh Display 


MICA s OE Wait for 3.00000 seconds 
Tap touchscreen at (1434, 1284) 


Press button HOME 





bugben WPS Office 











图 3-88 ”按键 命令 


3.5.3 ”输入 功能 Type Something 











第 三 个 选项 为 输入 功能 (Type Something) ， 即 对 输入 框 进行 文本 输入 (如 这 里 我 们 输入 的 文本 “bugben 微 信 : 巴 哥 奔 ”) ， 如 图 3-89 所 示 。 

















输入 完成 点 击 “ 确 定 ” 按 钮 后 如 图 3-90 所 示 。 











该 命令 导出 后 如 下 。 





TYPE | { 'message' :'bugben 微 信 : 巴 哥 奔 '，} 


对 应 接口 为 nonkeyrunner 的 type() 方 法 ， 如 下 。 





void type(string message) 





MonkeyRecorder - [ml xÍ 


[wat | press anton | Deseret Type eic A ee — Actions Refresh Display 


39:00 Wait for 3.00000 seconds 


Tap touchscreen at (1434, 1284) 
bugben SLAA WPS Office 









sane. 


se 
E F 


oe: ^ 
ITE 
v 


Press button HOME 









xi 
What to type? 


bugbeniS : BR] | 














图 3-89 ”输入 功能 


FA MonkeyRecorder 


Wart for 3.00000 seconds 
Tap touchscreen at (1434, 1284) 


ix ; Press button HOME 
Type “bugbenpeis : RFF" 


bugben SLAA WPS Office 








menee 








图 3-90 ”按键 命令 


对 应 脚本 为 如 代码 3-32 所 示 。 


代码 清单 3-32 ”输入 对 应 脚本 





txtl msg = ' bugben 微 信 : 巴 哥 奔 ' 

# Connect to the current device 

device = MonkeyRunner.waitForConnection () 
* Input txtl 

device.type(txtl msg) 


3.5.4 fif&IDBEFling 


9 个 选项 为 拖 搜 功 能 (Fling) ， 分 为 一 个 下 拉 框 和 两 个 输入 框 ， 下 拉 框 代表 方向 ， 分 为 北 (NORTH) 、 南 (SOUTH) 、 东 (EAST) 和 西 (WEST) 。 第 一 个 输入 框 为 拖 搜 长 度 ， 第 二 个 输入 框 为 步 

















长 ， 如 图 3-91 所 示 。 












FA MonkeyRecorder 


Lat | Pressatuton | ype someting —— 


ET LU c coo Wait for 3.00000 seconds 

Tap touchscreen at (1434, 1284) 
Press button HOME 

Type "bugbengttís : RFF" 







NPS Office 


I = =—sl x 


Which Direction to fling? 











How long to drag (in ms)? 


(1000 | 


How many steps to do it in? 


1 





0 


Esso n E: cw 











3-91 HEAR He 











这 里 选择 向 东 (EAST, BOI) ， 并 输入 拖 搜 长 度 为 1000， 步 长 为 10， 并 点 击 “ 确 定 ”按钮 ， 如 图 3-92 所 示 。 











2 MonkeyRecorder | [Bl 


wot] Pros oben Type =o. Export Actions Refresh Display 


Wait for 3.00000 seconds 
Tap touchscreen at (1434, 1284) 


Press button HOME 
8 S i Type “bugbenitifs : RFF" 


bugben WPS Office Fling east 








图 3-92” 拖 搜 命令 





该 命令 导出 后 如 下 。 
DRAG| ('start': (76,341) , 'end' : (384, 341) , 'duration':1,'steps':10, } 


对 应 接口 为 nonkeyrunner 的 drag() 方 法 ， 如 下 。 





void drag(tuple start, tuple end, float duration, integer steps) 


对 应 脚本 为 如 代码 3-33 所 示 。 


代码 清单 3-33 ” 拖 搜 对 应 脚本 


# Prepare start and end with 10 steps in 1s 
start = (76, 341) 

end = (384, 341) 

duration = 1 

steps = 10 

* Connect to the current device 

device = MonkeyRunner.waitForConnection () 

# Swipe from start to end 
device.drag(start, end, duration, steps) 


3.5.5 “录制 脚本 导出 功能 Export Actions 














第 五 个 选项 为 录制 脚本 导出 功能 (Export Actions) ， 即 将 录制 完成 的 脚本 导出 为 文件 ， 如 图 3-93 所 示 。 





FA MonkeyRecorder zx 


M | Preston | nmesanm | res | Poor acvons | RenesnDeny 


se UI 09: Wait for 3.00000 seconds 
Tap touchscreen at (1434, 1284) 


Eas o ij x 
保存 


文件 名 : 
文件 类 型 : 








3-93 ”录制 脚本 导出 











脚本 导出 后 ， 我 们 之 前 录制 的 脚本 如 代码 清单 3-34 所 示 。 


代码 清单 3-34 ”录制 示例 完整 脚本 





WAIT|('seconds':3.0,] 

PRESS | ('name' : ' HOME', ' type' : ' downAndUp' , ) 

TYPE | { 'message' : "bugbenfits : es^, } 

DRAG| ('start': (76,341), 'end': (384, 341), 'duration':1,'steps':10,]) 





3.5.6 ”录制 bugben 脚 本 示例 








最 后 ， 还 有 个 刷新 功能 Refresh Display， 用 途 是 : 刷新 当前 界面 (如 果 PC 端 显示 很 卡 的 话 ) 。 刷 新 功能 无 对 应 脚本 ， 这 里 就 不 单独 列 出 来 讲 了 。 














下 面 ， 我 们 尝试 录制 操作 巴 哥 奔 的 脚本 ， 脚 本 步骤 如 下 。 











E 





打开 bugben 应 用 。 








2) 点 击 文本 框 1。 

3) 输入 文本 “bugben”。 
4) 点 击 文本 框 2。 

5) 输入 文本 “bugben” , 
6) 等 待 1s。 

7) 点 击 提交 。 


8) 刷新 界面 。 








9) 回 到 主 界面 。 


10) 导出 脚本 。 








操作 界面 如 图 3-94 所 示 。 











图 MonkeyRecorder 


Wait Press a Button Type Something Fling Export Actions Refresh —À 


| + 3@ C 230.) Cham) 12:11 Tap touchscreen at (141, 232) 
bugben Tap touchscreen at (857, 288) 
请 在 下 框 中 输入 希望 修改 的 文字 : Type "bughen" 


a 2i Tap touchscreen at (641, 428) 
EB (ugbenais: 巴 哥 奔 Type “bugben" 


EC Tap touchscreen at (388, 664) 
EXAM 3095enQO:1971629467 Tap touchscreen at (590, 824) 
请 选择 文字 属性 : Tap touchscreen at (671, 956) 


ASH 13 = PR (im. 
MES (ania ©) aon 


文本 械 2 大 小 : 


(-)pe( ) 大 号 








图 3-94 bugben 脚 本 示例 录制 











点 击 “ 提 交 ” 按 钮 后 的 结果 显示 界面 如 图 3-95 所 示 。 

















导出 脚本 并 保存 为 bugben.mr， 如 代码 3-35 所 示 。 


代码 清单 3-35 ”bugben 录 制 脚本 





TOUCH| {'x':141, 'y':232, ' type' : 'downAndUp', 
TOUCH | {'x':857, 'y':288, ' type' : 'downAndUp', 
TYPE|('message': 'bugben',] 

TOUCH| ('x' :641, 'y':428, ' type' : 'downAndUp', 


TOUCH | ('x' :388, ! y' :664, ' type' : 'downAndUp', 
TOUCH | ('x' :590, 'y':824, ' type' : 'downAndUp', 
WAIT|('seconds':1. 0, 

Bel ETT !'y':956, "type! ;'downAndUp', 
PRESS | ('name': 'HOME', 'type':'downAndUp',] 


Hox 
Wait Press a Button Type Something Fling Export Actions Refresh Display 


S @ > w BOO 15:51 Tap touchscreen at (141, 232) 
ASAE: pug Tap touchscreen at (857, 288) 
Type "bugben" 

Tap touchscreen at (641, 428) 
b V b e n Type "bugben" 

g Tap touchscreen at (388, 664) 
Tap touchscreen at (590, 824) 
Tap touchscreen at (671, 956) 


bugben 














3-95 结果 显示 界面 








人 录制 的 这 个 脚本 ， 可 读 性 实在 让 人 头疼 1 | | 
e... 的 确 是 这 样 ， 所 以 这 款 官方 推荐 的 录制 回放 工具 既 不 叫好 也 不 叫座 ， 非 常 槛 炊 地 存在 于 天 地 之 间 。 
大 家 可 以 先 自行 理解 并 写 下 注释 ， 再 与 巴 哥 奔 的 注释 进行 对 比 ， 如 代码 清单 3-36 所 示 。 


代码 清单 3-36 ”bugben 录 制 脚本 (加 注释 ) 





4 点 击 bugben 应 用 坐标 

"s Fe :141, 'y':232, 'type' : ' downAndUp' , 
点 击 文本 框 1 

TOUCH| ('x' :857, 'y':288, ' type' : 'downAndUp', 

# 在 文本 框 1 内 输入 bugben 

TYPE | ('message' : 'bugben', } 

+ 点 击 文本 框 2 

TOUCH | ('x' :641, ! y' :428, 'type': 'downAndUp', 

* 在 文本 框 2 内 输入 bugben 

TYPE | ('message' : 'bugben', ) 

# 选择 加 粗 

+ teen 'y':664, 'type': 'downAndUp', 

# i m 

pees {'x':590, 'y':824, 'type':'downAndUp', 
等 待 1 秒 

WAIT| {'seconds':1.0, } 

# 点 击 提交 按钮 

ror PER 1671, 'y':956, 'type': 'downAndUp', } 
回 主 界面 

PRESS| ('name' : ' HOME' , ' type' : 'downAndUp' , ) 








脚本 分 析 完 毕 ， 接 下 来 让 我 们 看 看 回放 脚本 是 否 运行 正常 吧 ! 


3.5.7 ”回放 bugben 脚 本 





























回放 脚本 需要 用 到 monkey_playback.py， 这 是 当时 和 录制 脚本 一 并 从 源码 中 拷贝 出 来 的 ， 而 具体 用 法 代码 如 下 。 




















monkeyrunner monkey playback.py XXX.mr 





这 里 ， 我 们 将 运行 上 节 导 出 的 bugben.py， 代 码 如 下 。 





monkeyrunner monkey playback.py bugben.mr 











图 3-96 ”运行 结果 


Qi 为 了 方便 观察 结果 ， 可 先 去 掉 返 回 主页 那 行 代码 ， 或 在 返回 主页 前 调用 截屏 。 


另外 ， 如 果 中 间 程 序 反应 较 慢 ， 可 在 菜 些 操作 语句 (如 应 用 启动 等 ) 后 加 上 等 待 。 


3s. 


» 


Pr ARR IRA Hi p d? 


OS. cain rwr ! 


下 面 ， 让 我 们 一 起 来 看 看 monkey_playback.py 这 个 脚本 ， 如 代码 3-37 所 示 。 





代码 清单 3-37 monkey_playback.py 


Se OF OSE o ceo SHE HEHEHE HEHEHE He o HE 


!/usr/bin/env monkeyrunner 
Copyright 2010, The Android Open Source Project 


Licensed under the Apache License, Version 2.0 (the "License") ; 
you may not use this file except in compliance with the License. 
You may obtain a copy of the License at 





A 看 看 人 家 的 注释 ， 比 代 


http://www.apache.org/licenses/LICENSE-2.0 码 还 长 …… 


Unless required by applicable law or agreed to in writing, software 
distributed under the License is distributed on an "AS IS" BASIS, 
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
See the License for the specific language governing permissions and 
limitations under the License. 


import sys 两 大 段 注 释 之 间 ，import 


from com.android.monkeyrunner import MonkeyRunner "n 
Y B á 差点 看 不 见 


Se He SF OH dd Heo HR H 





The format of the file we are parsing is very carfeully constructed. 
Each line corresponds to a single command. The line is split into 2 
parts with a | character. Text to the left of the pipe denotes 

which command to run. The text to the right of the pipe is a python 







dictionary (it can be evaled into existence) that specifies the 
arguments for the command. In most cases, this directly maps to the 
keyword argument dictionary that could be passed to the underlying 


又 来 一 段 注释 ， 耐 心 学 学 吧 


Lookup table to map command strings to functions that implement that 


command. 





command. 


CMD MAP = { 这 是 关键 ,将 录制 脚本 里 的 操作 


'TOUCH': lambda dev, arg: dev.touch(**arg), 
'DRAG': lambda dev, arg: dev.drag(**arg), 


标识 转换 成 对 应 的 monkeyrunner 


脚本 API， 比 如 TOUCH 转 为 


dev.touch(**arg) 


'PRESS': lambda dev, arg: dev.press(**arg), 
'TYPE': lambda dev, arg: dev.type(**arg), 





'WAIT': lambda dev, arg: MonkeyRunner.sleep(**arg) 






: dumis a toa we lay Specified device. 该 方法 供 main0 函数 调用 ， 将 
j , j P p S. 
pole quinq ee 传 入 的 录制 脚本 按照 竖 线 (|) 进 


for line in fp: bh edie P 
(cmd, rest) = line.split(' | t) 414r fff , 这 就 是 录制 脚本 中 每 
try: 个 操作 后 面 跟 竖 线 的 原因 ， 如 


# Parse the pydict TYPE|{'message':'bugben', } 
rest = eval (rest) 


except: 
print ‘unable to parse options' 
continue 
if cmd not in CMD MAP: 
print 'unknown command: ' + cmd (MÀ aee ME 
continue 


对 于 CMD MAP 中 包含 


CMD MAP [cmd] (device, rest) ien 的 操作 将 参数 传人 对 
应 API 中 






def main(): - = 
file = sys.argv[1] main() 函数 ， 读 取 文 件 、 


fp = open(file, 'r') 创建 device 并 将 其 传人 
process file() 方法 


device = MonkeyRunner.waitForConnection() 


process file(fp, device) 
fp.close(); 


if | name == ' main ': 
main() 


呵呵 ， 够 简洁 吧 ” 够 给 力 吧 ? 


3.6 monkeyrunner 工 具 总 结 


OS cucu, 顺利 完成 任务 ， 和 希望 再 接 再 厉 ! 
$» 
-人 谢谢 ， 不 过 感觉 你 有 话 有 说 …… 
Ge 我 对 monkeyrunnet 超 级 API 里 面 提 到 的 用 例 运 行 很 感 兴趣 ， 完 竟 运 行 的 是 什么 样 的 用 例 脚 本 ? 这 个 用 例 脚 本 比 monkeyrunner 脚 本 更 强大 吗 ? 
Oran, 这 可 是 传说 中 的 Instrumentation 脚 本 ， 是 自动 化 的 属 龙 宝 刀 ， 在 很 长 一 段 时 间 里 ， 这 简直 就 是 做 自动 化 的 必 备 框架 ! 
a es 
哦 ， 那 这 个 所 谓 的 属 龙 宝刀 究竟 有 哪些 优点 呢 ? 
全 是 啊 ， 奔 哥 ， 你 给 解释 解释 ! 
eo, ,. monkey 父 子 都 是 依靠 控件 坐标 进行 定位 的 ， 而 控件 坐标 恰恰 是 项 目 中 的 最 不 稳定 因素 ， 随 时 会 因为 程序 员 对 控件 位 置 的 调整 而 导致 脚本 运行 失败 。 
人 不 用 坐标 用 什么 呢 ? 
| CM 则 主要 依靠 控件 ID ， 这 就 大 大 提高 了 脚本 稳定 性 。 
eo... 其 次 呢 ? 
90, Instrumentation 拥 有 成 熟 的 用 例 管理 框架 。 不 难 发 现 ，monkey 父 子 的 脚本 都 很 零散 ， 很 难 统 一 管理 和 运行 。 
69, inn, 还 有 呢 ? 


QO 第 三 ，Instrumentation 通 过 调用 控件 API 进 行 用例 编 写 ， 这 使 得 测试 脚本 执行 效率 非常 高 ， 脚 本 逻辑 性 和 可 读 性 都 非常 强 ， 也 非常 便于 维护 。 


OOs, monkey 父 子 的 脚本 你 要 不 加 注释 ， 我 简直 不 知道 你 写 的 是 什么 。 时 间 长 了 估计 你 自己 也 忘 了 ， 更 别提 维护 了 。 
B® nu, Instrumentation 的 确 是 Android 主 推 的 白 盒 测试 框架 ， 针 对 项 目 编写 成 体系 的 测试 用 例 集 主 要 靠 它 。 
BP on it AG, monkey 父子 只 是 用 来 玩 票 的 ， 这 个 才 是 真正 有 用 的 武器 


Q9, rerai, monkey 和 monkeyrunner 属 于 即 用 即 写 的 小 武器 ， 很 方便 也 很 简单 ， 既 不 用 编译 ， 也 不 依赖 源码 。 


eo. 果 Instrumentation 是 属 龙 刀 的 话 ，monkey 父 子 就 属于 小 李 飞 刀 一 类 的 ! 





http://www.ibm.com/developerworks/cn/mobile/mo-python-sl4a-1 


第 4 章 ”单元 测试 框架 Instrumentation 使 用 详解 





要 想 对 项 目 进 行 深入 的 、 系 统 性 的 单元 测试 ， 哪 能 离 得 开 Instrumentation 这 把 履 龙 宝刀 ? 


4.1 Instrumentation 概 述 





* 奔 哥 ， 你 对 这 款 框架 可 真是 一 往 情 深 啊 ! 
69, s. 先 给 大 家 介绍 一 下 吧 ! 


2o... 说 来 话 长 ， 且 容 我 慢 慢 道 来 …… 





从 Android 2.3 甚 至 更 早 版 本 发 布 时 就 尝试 进行 Android 自 动 化 或 单元 测试 的 同志 们 应 该 对 Instrumentation 非 常熟 悉 。 














当时 Android 官 方 还 未 推出 UIAutomator 这 款 专用 于 自动 化 测试 的 倚天 剑 ， 所 有 做 Android 自 动 化 的 同仁 们 都 聚集 在 Instrumentation 这 把 屠 龙 刀 下 一 一 无 论 是 直接 使 用 ， 还 是 借用 封装 好 的 
Robotium， 或 根据 业务 需要 对 Instrumentation 进 行 二 次 封装 ， 都 是 从 此 处 起 步 一 一 道路 不 可 谓 不 艰险 ， 未 来 不 可 谓 不 迷 范 。 















































但 还 好 ， 有 Instrumentation 这 萤 昏 黄 的 路 灯 指 引 着 前 方 ， 让 我 们 熬 过 了 那些 年 的 寒冬 。 





On, 好 一 个 文艺 青年 ， 我 都 被 你 感动 到 了 ! 接着 说 。 





Android Instrumentation 位 于 android.app 包 下 ， 与 Activity 处 于 同 级 目录 。 它 是 Android 系 统 里 面 的 一 系列 控制 方法 的 集合 (俗称 hook) 。 这 些 hook 可 在 正常 的 生命 周期 (正常 是 由 操作 系统 控制 
的 ) 之 外 控制 Android 控 件 的 运行 。 它 们 同时 可 以 控制 Android 如 何 加 载 应 用 程序 。 

















所 以 ，Activity 类 中 诸如 startActivity(Intent Intent) 等 基础 方法 均 通过 Instrumentation 实 现 ，Instrumentation 中 也 提供 了 一 系列 对 Activity 生 命 周期 控制 的 方法 。 











可 以 说 ，Instrumentation 就 是 Android SDK 在 Junit 上 的 扩展 ， 提 供 了 AndroidTestCase 类 及 系列 子 类 ， 其 中 最 重要 的 一 个 类 是 ActivitylnstrumentationTestCase2 一 一 在 UIAutomator 还 没 出 现 之 
前 ， 如 果 希 望 对 Android 应 用 界面 (Activity 和 View) 进行 操作 ， 必 经 之 路 就 是 Instrumentation (未 来 将 介绍 的 CTS 也 是 通过 这 条 必 经 之 路 对 界面 进行 控制 ) 。 
































在 Android 研 发 官网 上 搜索 “testing”， 会 有 这 样 一 篇 文章 供 你 参考 。 














(Testing Your Android Activity) (中 文 名 《Android 应 用 程序 测试 》， 网 址 : http://developer.android.com/trafinfing/activity-testing/index.html) 。 














这 篇 文章 将 Android 应 用 程序 测试 归结 如 下 。 








1) 设置 测试 环境 (Setting Up Your Test Environment) : 学 习 如 何 创建 测试 工程 。 


2) 创建 测试 用 例 (Creating and Running a Test Case) : 学 习 如 何 通过 Android framework 提 供 的 Instrumentation test runner 为 待 测 应 用 创建 测试 用 例 。 





3) 测试 UI 组 件 (Testing UI Components) : 学 习 如 何 测试 应 用 中 的 UI 组 件 。 


4) 创建 单元 测试 (Creating Unit Tests) : 学 习 如 何 进 行 Android 的 单元 测试 。 





5) 创建 功能 测试 (Creating Functional Tests) : 学 习 如 何 进行 Android 的 功能 测试 (这 里 指 自动 化 测试 ) 。 














除 此 之 外 ，Android 官 网 自然 少不了 详细 的 测试 专栏 (http://developer.android.com/tools/testing/index.html) ， 下 面 就 以 官网 提供 的 测试 教程 为 线索 向 大 家 简单 追溯 一 下 Instrumentation 的 前 世 




















哥 ， 官 网 上 面 全 是 英文 ， 你 能 帮 我 翻译 成 中 文 吗 ? Bw! 
eo... 我 原先 的 确 计 划 翻 译 官网 测试 教程 文章 ， 后 来 突然 发 现 一 位 名 为 “引路 蜂 ” 的 博 主 已 经 翻译 且 翻 译 得 很 到 位 ， 本 章 后 续 将 引用 他 的 部 分 翻译 ， 在 此 深 表 谢 意 ! 


Oez 详 见 引路 蜂 《Android 测 试 教程 》 专 栏 文 章 : 


http:/ /www.imobilebbs.com/wordpress/archives/2764 


42 Instrumentation 基 础 
| — 但 感觉 很 乱 ， 先 给 大 家 补 补 自 动 化 测试 基础 吧 ! 
4.2.1 ”自动 化 测试 基础 


= 对 某 个 系统 进行 自动 化 测试 之 前 ， 需 要 具备 3 个 基础 。 














经 验 丰富 的 自动 化 或 单元 测试 工程 师 都 深 知 一 个 道理 : 测试 某 个 系统 ， 无 论 是 最 简单 的 图 书 借阅 系统 ， 还 是 最 复杂 的 操作 系统 ， 如 果 要 进行 深入 测试 ， 必 须 具 备 3 个 基础 。 


























1) 对 待 测 系统 组 件 的 深入 了 解 : 尤 指 系统 运行 组 件 ， 对 于 自动 化 而 言 还 包括 界面 控件 等 。 








2) 系统 测试 框架 分 析 : 包括 系统 是 否 自 带 测试 框 架 ， 测 试 框架 粒度 是 否 够 细 ， 测 试 框架 对 系统 的 掌控 程度 如 何等 。 





























3) 丰富 的 测试 基础 知识 : 即 巴 哥 奔 常 常 提 及 的 边界 值 、 等 价 类 、 决 策 表 和 状态 机 等 用 例 设计 基础 理论 。 








第 一 点 是 为 了 知 彼 ， 第 二 点 是 为 了 知己 ， 第 三 点 是 立足 于 知己 知 彼 之 上 的 测试 设计 ， 三 者 缺 一 不 可 。 
$9, 先 来 看 看 对 于 Android 系 统 ， 它 的 组 件 包括 哪些 内 容 。 


对 于 Android 系 统 ， 它 的 组 件 包括 如 下 内 容 。 















































1) Activity: 应 用 程序 的 界面 ， 每 个 界面 都 可 成 为 一 个 Activity，Activity 之 间 通 过 Intent 进 行 通信 ， 其 上 为 界面 控件 ， 用 于 监听 并 对 用 户 的 事件 做 出 响应 。 

















2) Service: 后 台 服 务 程序 ， 可 以 理解 为 没有 用 户 界面 的 Activity， 可 用 来 开发 如 监控 类 程序 ， 或 一 些 无 需 交 互 的 程序 (如 下 载 等 ) 。 






































3) Content Provider: 应 用 程序 将 指定 数据 集 提 供给 其 他 应 用 程序 ， 其 他 应 用 可 以 通过 ContentResolver 类 从 该 内 容 提 供 者 中 获取 或 存 入 数据 。 这 些 数据 可 以 存储 在 文件 系统 、SQLite 数 据 库 或 以 任何 
其 他 合理 的 方式 存储 (如 某 个 永久 存储 设备 等 ) 。 
































4) Broadcast: 没有 用 户 界面 ， 但 可 以 通过 通知 栏 显 示 消息 通知 。 系 统 或 应 用 通过 NotificationManager 通 知 其 他 组 件 ， 也 可 启动 一 个 Activity 或 Service 来 响应 它们 收 到 的 消息 。 
































Orr 的 Android 四 大 组 件 ! 




















不 难看 出 ，Activity 是 自动 化 测试 关注 的 焦点 所 在 ， 而 Service 作 为 后 台 服 务 也 需要 花 精力 测试 ， 每 个 测试 都 离 不 开 对 数据 相关 的 操作 ， 所 以 Content Provider 自 然 也 是 测试 必 不 可 少 的 一 部 分 ， 而 在 测 
试 前 3 类 组 件 的 过 程 中 ， 无 疑 都 会 用 到 Broadcast 发 送 和 接收 通知 ， 如 果 Broadcast 出 现 问题 ， 那 其 余 3 项 测试 都 将 失败 。 
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Er 
SKAR Android I RUE J£ RAAF 4 96? 
4.2.2 Android 测 试 框架 


QO arid 测试 框架 ATF(Android TestingFramewotk) 为 Android 开 发 环境 的 一 个 组 成 部 分 。 

















局 4-1 所 示 。 巴 哥 奔 对 每 一 个 模块 进行 了 独立 备注 ， 以 供 大 家 参考 。 
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Android 测 试 框架 可 以 用 来 测试 Android 的 各 个 方面 ， 从 单元 测试 、 框 架 测试 到 UI 测试 等 ， 其 3 







































Eclipse Hj ADT £& 
含 了 创建 测试 用 例 


process MN SDK TA, 3f 























9 提供 用 于 和 其 他 

IDE 集成 的 命令 行 

人 下 Application package TestTools || E. eee 
以 从 被 测试 的 应 用 








测试 包 中 ， 这 个 测试 包 和 


主 应 用 程序 包 具 有 类 似 的 程序 包 读 取 所 需 信 


结构 ， 创 建 测试 包 的 步骤 es eundi a 
- build < 


和 创建 Android 应 用 的 方 
法 基本 类 似 










mainfest 文件 和 文 
件 目录 结构 等 






InstrumentationTestRunner 


MonkeyRunner 


DS 


SDK 也 提供 了 我 们 熟悉 的 














Test package 





如 果 你 刚 开 始 


接触 Android 测 monReyrunner T.H. (python 
试 ， 可 以 先 通过 AN 脚本 )， 可 以 模拟 用 户 按键 
AndroidTestCase 事件 来 测试 UI 


写 一 些 通用 的 测 
试用 例 ， 然 后 再 
写 较 复杂 的 测试 Test case classes Mock objects 


用 例 


NS 














Android JUint 扩展 
提供 了 对 Android 特 
定 组 件 (如 Activity、 
Service) 的 测试 文 
持 ， 这 些 扩展 类 提供 
了 一 些 辅助 方法 来 帮 
助 我 们 创建 测试 使 用 
的 “ 桩 ”类 或 方法 


Instrumentation 





Android 测试 框架 基于 JUnit， 因 此 可 以 
直接 使 用 JUnit 来 测试 一 些 与 Android P 
台 不 是 很 相关 的 类 ， 或 者 使 用 Android 的 
JUint 扩展 来 测试 Android 组 件 


图 4-1 Android 测试 框架 


m 
Sk, RAA] T monkeyrunner! 





eo... ， 这 里 monkeyrunnet 不 是 重点 ， 这 张 图 非常 清晰 地 告诉 我 们 ，Android 的 测试 套件 基于 JUnit，Instrumentation 是 针对 Android 系 统 的 JUnit 扩 展 。 











E 
CUORE, ELM A? 
$99, 少 说 明 两 点 …… 


其 一 ， 对 于 基础 的 (这 里 指 不 涉及 Android 的 API 的 组 件 ) 项 目 ， 我 们 仍 可 直接 通过 JUnit 进 行 单元 测试 ， 而 JUnit 是 Java 单 元 测试 的 根本 ， 可 以 看 出 这 是 一 脉 相 承 的 。 














其 二 ， 对 于 调用 Android 的 API 的 组 件 的 项 目 ， 我 们 可 通过 Instrumentation 进 行 单元 测试 或 自动 化 测试 。 








s» 
人 Instrumentation 究 竟 对 JUnit 进 行 了 哪些 方面 的 扩展 ? 


£6, s. Android 组 件 通常 运行 在 系统 预定 的 生命 周期 中 ， 如 图 4-2 所 示 。 








Android 组 件 生命 周期 对 应 的 回调 ， 如 图 4-2 所 示 。 























从 图 4-2 可 以 看 出 ，Activity 处 于 不 同 状态 时 将 调用 不 同 的 回调 函数 。 但 Android API 不 提供 
类 通过 “hooks” 控 制 着 Android 组 件 的 正常 生命 周期 ， 同 时 控制 Android 系 统 加 载 应 上 

















Android 控 件 运行 的 生命 周期 是 由 操作 系统 决定 的 。 例 如 ，Activity 对 象 的 生命 周期 









































的 时 候 ， 该 Activity 的 onPause() 方 法 就 会 被 调用 ， 如 果 该 Activity 的 代码 调 











图 4-2 


创建 Activity 时 被 回调 


启动 Activity 时 被 回调 


重启 Activity 时 被 回调 





恢复 Activity 时 被 回调 





暂停 Activity 时 被 回调 


停止 Activity 时 被 回调 


销毁 Activity 时 被 回调 


Android 组 件 生命 周期 对 应 的 回调 函数 

















程序 。 




















了 finish 











被 Intent 启 动 时 ， 该 Activity 对 象 的 onCreate() 方 法 就 会 被 调 
方法 ， 那 么 onDestroy() 方 法 就 会 被 调用 。 









































接 调 用 这 些 回调 函数 的 方法 ， 在 Instrumentation 中 则 可 以 这 样 做 。 在 Android 系 统 中 ，Instrumentation 


， 紧 接着 是 onResume( 方 法 ， 当 用 户 启动 另外 一 个 应 




















操作 系统 把 一 个 应 用 的 所 有 控件 都 运行 在 同一 个 进程 里 面 。 你 可 以 允许 一 些 (特别 的 ) 控件 运行 在 不 同 的 进程 中 (比如 Content Providers) ， 但 是 你 无 法 将 一 个 应 用 和 另外 一 个 已 经 在 运行 的 应 





一 个 进程 内 运行 。 








通过 Instrumentation， 我 们 可 以 在 测试 代码 中 调用 这 些 回调 函数 ， 就 像 在 调试 该 控件 一 样 一 步 一 步 地 进入 到 该 控件 的 整个 生命 周期 中 。 

















m} 


网 提供 如 下 代码 供 大 家 参考 ， 如 代码 清单 4-1 所 示 。 








代码 清单 4-1 Instrumentation 官 网 示例 代码 














侍 同 








// xuben: 获取 待 测 应 用 


mActivity = getActivity(); 

// xuben: 获取 下 拉 列 表 框 

mSpinner = (Spinner)mActivity.findViewById (com.android.example.spinner.R.id.Spinner01); 
// xuben: 设置 下 拉 列 表 框 位 置 

mActivity.setSpinnerPosition(TEST STATE DESTROY POSITION); 

// xuben: 停止 待 测 应 用 (此 时 控件 信息 应 保存 ) 

mActivity.finish(); 

// xuben: 重启 待 测 应 用 

// 注意 : 这 里 不 能 通过 onResume () 方 法， 否则 控件 信息 将 重 置 

mActivity = getActivity(); 

// xuben: 获取 下 拉 列 表 框 当前 位 置 
int currentPosition = mActivity.getSpinnerPosition(); 

// xuben: 判断 下 拉 列 表 框 当前 位 置 应 为 之 前 设置 的 位 置 

assertEquals(TEST STATE DESTROY POSITION, currentPosition); 














这 段 代 码 演示 如 何 使 用 Instrumentation 去 控制 Activity 保 存 和 恢复 其 状态 。 



































这 里 用 到 的 关键 方法 是 Instrumentation APl 里 面 的 getActivity0， 待 测 的 Activity 在 没有 调用 此 方法 的 时 候 是 不 会 启动 的 。 


























当然 ,我 们 也 可 以 先 把 测试 需要 的 环境 配置 好 ， 然 后 再 调用 此 方法 来 启动 待 测 Activity。 


























同时 ，Instrumentation 可 以 把 测试 包 和 被 测 应 用 加 载 到 同一 个 进程 中 运行 。 既 然 各 个 控件 和 测试 代码 都 运行 在 同一 个 进程 中 了 ， 测 试 代码 就 可 直接 调用 这 些 控件 的 方法 ， 同 时 修改 和 验证 这 些 控件 也 
非常 容易 。 









































除了 针对 组 件 的 生命 周期 的 控制 和 调试 外 ，Instrumentation 还 可 针对 控件 的 方法 进行 直接 调用 ， 也 可 对 控件 的 属性 进行 查看 和 修改 。 








88., 这 样 说 大 家 感觉 不 是 很 明显 ， 下 面 就 在 实践 中 感受 一 下 吧 ! 


43 ”第 四 个 Impossible Mission 


V Oe + Rie, PLEA AFAT MIA DR RRE, Andre 





当 你 面 对 这 样 一 个 项 目 : HelloBugben， 如 图 4-3 所 示 。 

















" ] 1 HelloBugben 
| zi GB src 
= | EB. com.xuben.hellebugben 
: J) HelloBugbenActivity. java 
H- Android 4.2.2 
H- e gen [Generated Java Files] 
: 5 assets 
内: e bin 
E LP res 
由 (= drawable-hdpi 
P drawable-Idpi 
+) > drawable-mdpi 
* d EE. 


-Ð PE A ml 
[X] link.xml 
B — cg 











首先 ， 双 击 打 开 HelloBugbenActivityjava， 如 代码 清单 4-2 所 示 。 














代码 清单 4-2 HelloBugbenActivity.java 





package com.xuben.hellobugben; 
import android.app.Activity; 
import android.graphics.Color; 
import android.os.Bundle; 
import android.widget.TextView; 
public class HelloBugbenActivity extends Activity 
private TextView textviewl; 
private TextView textview2; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
char char bugben[] = new char[6]; 


char bugben[0] = 'b'; 
char bugben[1] = 'u'; 
char bugben[2] = 'g'; 
char bugben[3] = 'b'; 
char bugben[4] = 'e'; 
char bugben[5] - 'n'; 


String str bugben - "bugben"; 

textviewl - (TextView) findViewById (R.id.myTextView01) ; 

textviewl.setText(char bugben, 0, 6); 

TextPaint tp = textviewl.getPaint(); 
tp.setFakeBoldText (true); 

textview2 =(TextView) findViewById(R.id.myTextView02) ; 

textview2.setText (str_bugben) ; 

textview2.setTextSize (60) ; 


} 
public String addTxt (String txtl, String txt2) ( 
return (txt1 + txt2); 
} 





EU 
“区 这 个 程序 员 很 不 负责 啊 ， 什 么 猪 食 (注释 ) ABA 
[= 

，”OK， 没 事 ， 让 我 们 先 运 行 一 下 看 看 。 


HelloBugben 项 目 运行 结果 ， 如 图 4-4 所 示 。 











fe 
CUR? 这 不 就 是 咱们 之 前 测试 的 Bugben 应 用 结果 显示 界面 吗 ? 


go... 那 就 让 我 们 自己 分 析 一 下 ， 并 给 代码 加 上 注释 吧 ! 


加 上 注释 后 的 代码 ， 如 代码 清单 4-3 所 示 。 





代码 清单 4-3” 带 注释 的 HelloBugbenActivityjava 





package com.xuben.hellobugben; 
import android.app.Activity; 
import android.graphics.Color; 
import android.os.Bundle; 
import android.widget.TextView; 
import com.xuben.helloandroid.R; 
public class HelloBugbenActivity extends Activity { 
private TextView textviewl; 
private TextView textview2; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 
// xuben: 这 里 通过 字符 数组 char bugben[] 组 合 了 字符 串 "bugben" 
char char bugben[] = new char[6]; 


char bugben[0] = 'b'; 
char bugben[1] = 'u'; 
char bugben[2] - 'g'; 
char bugben[3] = 'b'; 
char bugben[4] = 'e'; 
char bugben[5] = 'n'; 


// xuben: 这 里 直接 是 字符 串 形式 "bugben" 
String str bugben = "bugben"; 
// xuben: %—+XLAEtextviewl, idAmyTextView01 
textviewl =(TextView) findViewByld (R.id.myTextView01) ; 

// xuben: 为 第 一 个 文本 框 赋值 字符 数组 char bugben[] ， 即 "bugben" 
textviewl.setText(char bugben, 0, 6); 

// xuben: 为 第 一 个 文本 框 设置 文本 属性 : 加 粗 

TextPaint tp = textviewl.getPaint(); 

tp.setFakeBoldText (true); 

// xuben: 第 二 个 文本 框 textview2， 其 id 为 myTextView02 
textview2 = (TextView) findViewById (R.id.myTextView02); 

// xuben: 为 第 二 个 文本 框 赋值 字符 串 str_ bugben, Fp "bugben" 
textview2.setText (str_bugben) ; 

// xuben: 为 第 二 个 文本 框 设置 文本 大 小 : 60 

textview2.setTextSize (60); 





l 

// xuben: 组 合 字符 串 方法 addTxt () 

public String addTxt(String txtl, String txt2) ( 
return(txtl 十 txt2); 
} 









< 


全 还 算 简 单 ， 接 下 来 咱们 该 干什么 ? 


$9, ia 们 看 看 布局 设置 吧 ! 











打开 “res->layout->main.xml” 查 看 布局 设置 ， 如 图 4-5 所 示 。 
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4-5 布局 设置 








打开 main.xml， 如 代码 清单 4-4 所 示 。 


代码 清单 4-4 main.xml 





<?xml version-"1.0" encoding-"utf-8"?» 
<AbsoluteLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:orientation-"vertical" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 
<TextView 
android: id="@+id/myTextView01" 
android: layout_x="40dip" 
android: layout_y="40dip"™ 
android: layout_width="fill parent" 
android: layout_height="fill_ parent" 
android: text="@string/str_textview01" 
y ua textSize-"40sp" 
> 
<TextView 
android: id="@+id/myTextView02" 
android: layout_x="160dip" 
android: layout_y="160dip" 
android: layout_width="fill parent" 
android: layout_height="fill_ parent" 


android: text="@string/str_textview02" 
android: textSize="40sp" 
/> 

</AbsoluteLayout> 





从 “android:textSize” 标 签 我 们 可 以 看 出 ， 文 本 默认 大 小 被 设置 为 40sp 了 。 
再 打开 string.xml 看 看 ， 如 代码 清单 4-5 所 示 。 


代码 清单 4-5 string.xml 





<?xml version-"1.0" encoding="utf-8"?> 
«resources» 
<string name="hello">Hello Bugben!</string> 
<string name="app_name">bugben</string> 
«string name-"str textview01">Bugben 微 信 公 众 号 : E 3 4</string> 
«string name-"str textview02"»Bugben QQ:1971629467</string> 
</resources> 





fe 
人 好 了 ， 关 于 这 个 项 目 ， 我 们 算是 有 个 基本 了 解 了 ! 那 咱们 该 怎么 测试 呢 ? 


44 Instrumentation 的 前 世 : 单元 测试 基础 框架 JUnit 


2o, 为 Instrumentation 的 前 世 ，JUnit 早 在 Android 诞 生 以 前 就 以 Java 代 码 单 元 测试 基础 框架 的 身份 名 满 天 下 ! 














我 们 知道 ， 一 个 完整 的 自动 化 用 例 需要 以 下 几 部 分 的 配合 。 











1) 测试 用 例 开始 前 的 资源 准备 和 预先 设置 。 








2) 测试 用 例 步骤 执行 及 验证 点 检验 。 














3) 测试 用 例 结束 后 的 环境 清理 。 


B. s ue 生 ! 








1) 测试 用 例 开始 前 的 资源 准备 和 预先 设置 : Setup() 方 法 。 








2) 测试 用 例 步骤 执行 及 验证 点 检验 : Assert() 方 法 。 














3) 测试 用 例 结束 后 的 环境 清理 : Teardown() 方 法 。 


m 
全 JUnit 的 原理 又 是 什么 ? 





$o,, Jm, RABAT Hk BH, RB! 
特此 声明 : 


这 里 ， 巴 哥 奔 不 打算 从 JUnit 的 起 源 、 发 展 等 历史 说 起 ， 也 不 打算 一 步 步 地 向 大 家 演示 JUnit 的 下 载 、 安 装 、 运 行 和 注意 事项 ， 这 些 技术 细节 网 上 应 有 尽 有 一 一 对 于 monkey、monkeyrunner、UIAutomator 和 
CTS 等 均 是 如 此 ， 以 免 无 谓 地 浪费 大 家 时 间 。 








作为 一 款 成 熟 的 单元 测试 框架 ，JUnit 的 目的 非常 明确 一 一 通过 该 框架 可 以 为 被 测 代码 编写 相应 的 测试 代码 ， 以 实现 快速 定位 错误 、 减 小 回归 错误 的 纠 错 难度 、 节 省 调试 时 间 ， 最 终 提高 代码 健壮 性 。 



































为 达到 该 目的 ，JUnit 的 框架 设计 就 应 该 尽 可 能 地 贴近 实际 测试 ， 而 标准 黑 盒 测 试用 例 的 设计 思路 就 是 最 佳 参照 物 个 标准 的 黑 盒 用 例 ， 无 论 格式 如 何 ， 在 执行 前 都 会 考虑 “前 提 条 件 ” (或 称 “ 预 
置 条 件 ”) ， 在 用 例 执行 结束 后 也 不 可 避免 地 要 考虑 “环境 清理 ”。 只 有 这 样 ， 才 能 确保 每 个 用 例 都 是 互相 独立 的 ， 以 便 在 任何 时 候 都 能 以 任意 顺序 运行 单独 的 用 例 或 任意 用 例 组 合 。 










































































JUnit 框 架设 计 如 代码 清单 4-6 所 示 。 


| OPER. 了 这 一 精华 ， 框 架设 计 为 如 下 代码 


代码 清单 4-6_ JUnit 框架 设计 





setUp(){ http: //www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/... } 
testMethodl()( http://www.hzcourse. com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/ E 
testMethod2(){ http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/... } 

tearDown() { http: //www .hzcourse .com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15501/OEBPS/Text/ saat 























不 难看 出 ，setUp() 方 法 就 是 黑 盒 用 例 中 的 “前 提 条 件 ”， 而 tearDown() 方 法 则 是 “环境 清理 ” ， 而 框架 会 在 调用 每 个 测试 方法 前 强制 执行 setUp() 方 法 以 确保 前 提 条 件 的 准备 ， 在 每 个 测试 方法 运行 完 
成 后 强制 执行 tearDown() 方 法 以 确保 环境 已 经 清理 干净 。 






























































而 每 一 个 测试 方法 ， 可 以 看 作 一 个 个 黑 盒 测试 用 例 ， 而 测试 用 例 最 重要 的 ， 莫 过 于 它 的 检查 点 (check point) 是 否 得 到 充分 有 效 的 验证 一 一 没有 什么 比 漏 掉 检 查 点 更 糟糕 的 事 了 。 而 JUnit 自 然 也 不 
会 ， 它 通过 各 种 断言 (assert) 将 一 个 个 检查 点 封装 好 (当然 ， 你 也 可 以 根据 项 目 需要 自 定义 新 的 断言 ) 。 














另外 ， 一 组 单元 测试 可 以 被 组 织 成 若干 个 TestSuite， 每 个 TestSuite 包 含 若干 TestCase ( 某 个 继承 android.jar 的 junit.framework.TestCase 的 类 ) ， 每 个 TestCase 又 包含 若干 个 testMethod. 


常见 断言 如 代码 清单 4-7 所 示 。 








// xuben: 判断 条 件 是 否 为 真 
assertTrue([String msg], boolean condition); 


// xuben: 判断 条 件 是 否 为 假 


assertFalse([String msg], boolean condition); 

// xuben: 判断 期 望 值 (expected) 与 实际 值 (actual) 是 否 相等 
assertEquals([String msg], expected, actual); 

// xuben: 判断 值 是 否 为 空 

assertNull([String msg], java.lang.Object object); 





有 了 断言 ， 就 可 以 在 用 例 (测试 方法 ) 中 对 一 个 个 检查 点 进行 判断 了 。 此 时 ， 一 个 基本 的 测试 框架 就 算 完 成 了 一 一 当然 ， 你 还 可 以 说 JUnit 不 止 这 些 ， 还 有 这 样 那样 的 模块 和 功能 ， 但 就 本 书 要 讨论 的 内 
容 而 言 ， 这 些 足够 了 ! 











示例 如 代码 清单 4-8 所 示 。 


代码 清单 4-8 ”代码 示例 






setUp(){ ... } } 前 提 : 环境 准备 


testMethodl () { : z 3 
ji AS | 第 1 个 测试 用 例 | 第 1 个 测试 用 例 
assertXXX(...); 


Ee 用 例 1 的 第 1 个 检查 点 
assertYYY(...); } KL 用 例 1 的 第 2 个 检查 点 


testMethod2 () { È 第 2 个 测试 用 例 


assertZZZ(...); } < oo = 用 例 2 的 第 1 个 检查 点 


} 


tearDown(){ ... } = 收尾 : 环境 清理 








既然 已 经 具备 基本 测试 框架 ， 下 面 我 们 就 开始 试 着 对 bugben 项 目 做 一 些 简单 测试 。 


我 们 需要 先 来 了 解 一 下 如 何 创建 测试 项 目 。 








很 多 教程 都 建议 大 家 在 创建 项 目 时 就 创建 测试 项 目 。 事 实 上 ， 在 实际 工作 中 创建 项 目的 时 候 ， 是 不 确定 是 否 需要 创建 测试 项 目的 。 尤 其 是 开发 项 目 一 般 是 由 研发 工程 师 创建 的 ， 而 测试 项 目 则 是 由 测试 
工程 师 创建 的 ， 不 同 的 测试 工程 师 有 可 能 为 同一 个 项 目 创建 各 自 的 测试 项 目 ， 所 以 这 里 巴 哥 奔 还 是 分 开 介绍 。 






































首先 ， 创 建 Android 项 目 ， 这 个 具体 可 参考 Android 基 础 开发 的 书籍 ， 此 处 简单 介绍 : 选择 “New->Other->Android Application Project”， 如 图 4-6 所 示 。 





New Android Application 


New Android Application 
Creates a new Android Application 


Required SDK:O|API 17: Android 4.2 (Jelly Bean) 国 
tspeOjaPliz;Andoid42QelyBeer)  ž = ž = 
本 apI 17: Android 4.2 (Jelly Bean) = =ë : & 











图 4-6 ”创建 Android 项 目 





然后 一 路 点 击 “Next” 按 钮 进行 设置 ， 最 后 点 击 “finish” 按 钮 即 可 完成 ， 如 图 4-7 所 示 。 





7-55 HelloBugben 
: B 48 src 
|. EB. com.xuben.hellobugben 

: op HAS) HelloBugbenActivity.jave 
*J-E9 Android 4.2.2 
Ch es gen [Generated Java Files] 
: e» assets 
8» bin 
B i> res 
: 由 (=> drawable-hdpi 
4 den drawable-Idpi 
之 drawable-mdpi 
由 T layout 
: 5 values : 
-B AndroidManifest. xml 
[X] link, xml 
E proguand. cfg 





在 刚 创建 的 项 目 上 点 击 鼠 标 右键 ， 选 择 “New->Other->Android Test Project" ， 创 建 测试 项 目 ， 如 图 4-8 所 示 。 


New Android Test Project 


Create Android Project 
Select project name and type of project 


[ Add proje > wor 


Working sets; z | 


图 4-8 创建 测试 项 目 


选择 要 测试 的 项 目 ， 这 里 就 是 HelloBugben 项 目 了 ， 如 图 4-9 所 示 。 





New Android Test Project 


Select Test Target 
Choose a project to test 


indroid project: 


P HelloBugben 











图 4-9 选择 待 测试 的 项 目 


然后 点 击 “finish” 按 钮 即 可 完成 测试 项 目 创建 ， 如 图 4-10 所 示 。 





oF ee HelloBugbenTest 


com.) xuben. hellobugben.tes 
s gen [Generated Java | Files] 
由 HEA Android 4.2.2 
A assets 
- bin 
~«(Q) AndroidManifest.xml 
: ~ |S) proguard-project.txt 
-= [E] project.properties 


图 4-10 ”完成 测试 项 目 创建 





我 们 注意 到 ， 该 测试 项 目的 包 名 为 “com.xuben.hellobugben.test”， 而 被 测 项 目 包 名 为 “com.xuben.hellobugben” ， 这 就 说 明 该 测试 项 目 HelloBugbenTest 是 针对 项 目 HelloBugben 所 设置 的 。 





此 时 ， 该 测试 项 目下 还 没有 任何 类 ， 我 们 为 其 建立 一 个 测试 类 HelloBugbenTest。 





在 测试 包 上 点 击 鼠 标 右键 ， 选 择 “New 一 Class” 命令 ， 并 在 Name 一 项 填 入 “Hello-BugbenTestBase”， 如 图 4-11 所 示 。 











New Java Class 


Java Class 
Create a new Java class. 





DrOWSe rr 


| REMOVE 





图 4-11 建立 测试 类 HelloBugbenTest 


点 击 “finish” 按 钮 即 可 生成 测试 类 HelloBugbenTestBasejava， 如 图 4-12 所 示 。 





= Eu HelloBugbenTest 
=) src 
B-g8 com.xuben.hellobuaben.test 
Œ- [J] HelloBugbenTestBase.java 
gen [Generated Java Files] 
“BA Android 4.2.2 
a assets 
Qe» bin 
E res 
ci] AndroidManifest. xml 
| proquard-project.txt 
e: E project.properties 


4-12 ^E RMIX JE HelloBugbenTestBase.java 
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$e 
< 全 % 哇 ， 好 期 待 ， 赶 快 打开 来 看 看 1 


双击 打开 HelloBugbenTestBasejava， 发 现 里 面 空空 如 也 ， 如 代码 清单 4-9 所 示 。 


代码 清单 4-9 HelloBugbenTestBase java 





package com.xuben.hellobugben.test; 
public class HelloBugbenTestBase { 
} 





SAR, MURAT IURI UE rom? 


打开 AndroidManifest.xml， 将 会 发 现 其 包含 <Instrumentation> 标 签 ， 并 自动 将 “com.xuben.hellobugben” 设 为 其 targetPackage， 即 测试 对 象 ， 如 代码 清单 4-10 所 示 。 


代码 清单 4-10 AndroidManifest.xml 





«?xml version-"1.0" encoding="utf-8"?> 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com. xuben.hellobugben.test" 
android:versionCode-"1" 
android:versionName-"1.0" » 
«uses-sdk android:minSdkVersion-"10" /> 
XInstrumentation 

android:name-"android.test.InstrumentationTestRunner" 

android:targetPackage- “com.xuben.hellobugben” /> 
«application 

android: icon="@drawable/ic_launcher" 

android: label="@string/app_ name" > 

<uses-library android:name="android.test.runner" /> 
</application> 

</manifest> 





< 这 两 行 很 蹊跷 ， 其 中 必 有 隐情 …… 
26... 这 里 声明 了 测试 框架 ， 并 指定 了 待 测 项 目 包 名 。 接 下 来 ， 咱 们 就 一 步 步 地 尝试 编写 吧 ! 
第 一 步 ， 通 过 继承 测试 类 TestSuite， 将 junit 相 关 包 impot 进 来 ， 如 代码 清单 4-11 所 示 。 


代码 清单 4-11 ”继承 测试 类 TestSuite 





package com.xuben.hellobugben.test; 
import junit.framework.Test; 
import junit.framework.TestSuite; 
import android.graphics.Color; 
import android.test.suitebuilder.TestSuiteBuilder; 
public class HelloBugbenTest extends TestSuite ( 
public static Test suite() { 
return new TestSuiteBuilder (HelloBugbenTest.class) 
.includeAllPackagesUnderHere ().build(); 





第 二 步 ,创建 HelloBugbenActivity 对 象 hellobugben， 如 代码 清单 4-12 所 示 。 





代码 清单 4-12 HelloBugbenActivity 对 象 





HelloBugbenActivity hellobugben; 





第 三 步 ， 在 setUp() 方 法 中 完成 真正 的 对 象 创建 ， 如 代码 清单 4-13 所 示 。 


代码 清单 4-13 ”setUp0 方 法 





GOverride 
public void setUp()( 

hellobugben = new HelloBugbenActivity (); 
} 








第 四 步 ， 既 然 有 setUp() 方 法 ， 相 应 有 tearDown() 方 法 ， 如 代码 清单 4-14 所 示 。 











代码 清单 4-14 tearDown() 方 法 





GOverride 
public void tearDown() throws Exception( 
super.tearDown(); 


} 











第 五 步 ， 为 组 合 字符 串 方法 建立 测试 用 例 ， 如 代码 清单 4-15 所 示 。 








代码 清单 4-15 ”测试 用 例 





public void testAddTxt() ( 
assertEquals ("I Love Bugben Pirate Ship!", hellobugben.addTxt (txtl, txt2)); 


} 








其 中 ，txt1 和 txt2 分 别 为 : “| Love Bugben” 和 “Pirate Ship!”， 完 整 的 测试 工程 ， 如 代码 清单 4-16 所 示 。 





代码 清单 4-16 ”完整 的 测试 工程 





package com.xuben.hellobugben.test; 
import com.xuben.hellobugben.HelloBugbenActivity; 
import junit.framework.Test; 
import junit.framework.TestCase; 
import android.graphics.Color; 
import android.test.suitebuilder.TestSuiteBuilder; 
// xuben: 编写 JUnit 测 试用 例 需要 继承 Junit 的 基本 类 junit.framework.TestCase 
public class HelloBugbenTestBase extends TestCase { 

public static Test suite() ( 

return new TestSuiteBuilder (HelloBugbenTestBase.class) 
-includeAllPackagesUnderHere ().build(); 


l 

HelloBugbenActivity hellobugben; 

String txtl = "I Love Bugben"; 

String txt2 = "Pirate Ship!"; 

GOverride 

public void setUp()( 
hellobugben = new HelloBugbenActivity(); 

} 

QOverride 

public void tearDown() throws Exception( 
super.tearDown(); 


l 
// xuben: 测试 用 例 中 的 测试 方法 必须 以 test 开 头 ， 返 回 类 型 必须 是 void， 
// 参数 必须 为 空 ， 并 且 访 问 修饰 符 为 Public 的 成 员 方法 
public void testAddTxt() ( 
assertEquals ("I Love Bugben Pirate Ship!", hellobugben.addTxt(txtl, txt2)); 
} 





在 测试 项 目 HelloBugbenTest 上 点 击 鼠 标 右键 ， 在 菜单 “Run As” 中 选择 “Android JUnit Test”， 运 行 结果 如 图 





4-13 所 示 。 


I$ Package Explorer gf JUnit X — B 


9 $w BOR m E- 7 


Finished after 0.009 seconds 
Runs: 1/1 Errors: 0 B Failures: 0 


日 Ei] lenovo-lenovo a860e-MSM8625QSKUD [Runner: JUnit 3] (0.281 s) 


E- Ei] com.xuben.hellobugben.test.HelloBugbenTestBase (0.281 s) 





A413 运行 结果 
人 测试 成 功 ! “我 爱 巴 哥 奔 海 盗 船 ”组 装 完毕 ， 哈 哈 ! 
Qa Android 测 试 API 支 持 JUnit 3 代码 风格 ， 而 不 支持 JUnit 4 代码 风格 ， 且 只 能 通过 InstrumentationTestRunnet 来 运行 测试 用 例 。 
从 看 来 越 是 通用 的 框架 越 简洁 ， 而 对 于 通用 框架 的 扩展 也 是 紧 紧 围绕 着 被 测 系统 的 设计 有 针对 性 地 进行 的 。 


$9, ,. JUnit 在 设计 之 初 自然 不 可 能 考虑 到 Android 系 统 的 各 种 要 求 诸如 生命 周期 的 控制 权限 等 ) 。 
而 要 将 JUnit 的 思想 完美 地 应 用 到 Android 系 统 上 ， 就 必须 针对 Android 系 统 的 各 种 要 求 对 JUnit 进 行 适当 扩展 ， 这 也 是 自动 化 团队 针对 业界 成 熟 框架 做 二 次 封装 的 核心 思路 。 
45 ”第 五 个 Impossible Mission 


全 既然 JUnit 这 么 强大 ， 那 为 什么 还 需要 Instrumentation 呢 ? 


9, xmanune (如 系统 运行 组 件 、 系 统 界面 控件 等 ) 获取 和 控制 方式 不 同 。 











举 个 例子 ， 如 针对 Android 系 统 组 件 (Activity、Service 等 ) 的 控制 ， 对 于 Android 应 用 程序 生命 周期 (onCreate、onResume 等 ) 的 控制 ， 以 及 启动 和 调用 应 用 (如 强制 某 个 应 用 和 另 一 个 已 经 在 运 
作 的 应 用 运行 在 同一 个 进程 中 或 直接 调用 Activity 或 是 Service 的 生命 周期 回调 函数 ) 等 。 





e 
全 < 额 ， 你 成 功 地 把 我 说 党 了 …… 


T^ (c 
vf ORG T, 刚 接 到 通知 ， 程 序 员 们 又 把 代码 更 新 了 ! 


eo, 那 就 用 更 新 后 的 项 目 做 个 实验 来 说 明 吧 ! 
更 新 后 的 项 目 ， 如 代码 清单 4-17 所 示 。 


代码 清单 4-17 ”更 新 后 的 项 目 





package com.xuben.hellobugben; 
import android.R.integer; 
import android.R.string; 
import android.app.Activity; 
import android.os.Bundle; 
import android.text.TextPaint; 
import android.util.Log; 
import android.widget.TextView; 
public class HelloBugbenActivity extends Activity { 
private TextView textviewl; 
private TextView textview2; 
GOverride 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R. layout .main) ; 
String bugben_txt = "bugben"; 
Boolean bugben_bold = true; 
Float bugben_size = (float) 20.0; 
textviewl =(TextView) findViewByld (R.id.myTextView01) ; 
textview2 =(TextView) findViewByld (R.id.myTextView02) ; 
setTxt (bugben_txt) ; 
setTv1Bold (bugben_bold) ; 
setTv2Size (bugben_size) ; 
} 
public void setTxt (String txt) { 
textviewl.setText (txt); 
textview2.setText (txt); 


public void setTv1Bold (Boolean bold) { 
TextPaint tp = textviewl.getPaint(); 


tp.setFakeBoldText (bold); 
} 
public void setTv2Size (Float size) { 
TextPaint tp xtview2.getPaint (); 
tp.setTextSi ze); 
} 
} 


生 ， 简 直 完 全 改头换面 了 ， 这 帮 程 序 员 有 钱 就 是 任性 


哈哈 ， 没 办 法 ， 咱 们 没 钱 还 是 认命 吧 ， 先 运行 一 下 看 看 吧 ! 


运行 结果 ， 如 图 4-14 所 示 。 




















eo. 果 这 个 项 目 交 给 你 ， 你 会 怎么 做 ? 





能 怎么 做 ? 照 你 之 前 那样 ， 用 JUnit 框 架 继 续 做 ! 








而 我 们 继续 套用 之 前 的 测试 项 目的 话 ， 如 代码 清单 4-18 所 示 。 








代码 清单 4-18 ”套用 测试 项 目 





package com.xuben.hellobugben.test; 
import junit.framework.Test; 
import junit.framework.TestCase; 
import com.xuben.hellobugben.HelloBugbenActivity; 
import com.xuben.hellobugben.R; 
import android.os.Handler; 
import android.test.suitebuilder.TestSuiteBuilder; 
import android.text.TextPaint; 
import android.widget.TextView; 
public class HelloBugbenTestBase extends TestCase { 
public static Test suite() ( 
return new TestSuiteBuilder (HelloBugbenTestBase.class) 
-includeAllPackagesUnderHere ().build(); 


} 

HelloBugbenActivity hellobugben; 

private TextView textviewl; 

private TextView textview2; 

private Handler handler - null; 

String bugben txt = "bugben"; 

Boolean bugben bold - true; 

Float bugben size = (float) 20.0; 

Float value; 

GOverride 

public void setUp() throws Exception{ 
super.setUp(); 
hellobugben = new HelloBugbenActivity (); 
// xuben: 获取 这 两 个 TextView 
textviewl -(TextView)hellobugben.findViewById (R.id.myTextView01) ; 
textview2 = (TextView)hellobugben.findViewById (R.id.myTextView02); 
// xuben: 创建 属于 主线 程 的 handler 
handler = new Handler(); 

l 

GOverride 

public void tearDown() throws Exception( 
super.tearDown(); 


} 
public void testSetTxt() { 
// xuben: 启动 新 线程 进行 控件 文本 设置 
new Thread()( 
public void run() { 
handler.post (runnableTxt); 
} 
].start(); 
// xuben: 获取 textview1 控 件 文本 
String cmpTxt = textviewl.getText ().toString(); 
// xuben: 将 获取 文本 与 设置 文本 进行 对 比 
assertTrue (cmpTxt.compareToIgnoreCase (bugben txt) == 0); 


} 

public void testSetBold() { 
// xuben: 设置 控件 属性 : 加 粗 
hellobugben.setTvlBold (bugben bold); 
// xuben: 获取 textviewl 控 件 属性 
TextPaint tp = textviewl.getPaint (); 
Boolean cmpBold = tp.isFakeBoldText (); 
// xuben: 获取 的 属性 应 为 true (加 粗 ) 
assertTrue (cmpBold); 


l 
public void testSetSize() { 
// xuben: 设置 控件 文本 大 小 
hellobugben.setTv2Size (bugben size); 
// xuben: 获取 textview2 控 件 文本 大 小 
Float cmpSize = textview2.getTextSize(); 
// xuben: 将 获取 文本 与 输入 文本 进行 对 比 
assertTrue (cmpSize.compareTo (bugben size) — 0); 


l 
// xuben: 构建 Runnable 对 和 象 ， 在 runnable 中 设置 文本 
Runnable runnableTxt = new Runnable (){ 
GOverride 
public void run() { 
// xuben: 设置 控件 文本 
hellobugben.setTxt (bugben txt); 








eo 自己 运行 一 下 试 试 ! 


编译 没有 任何 问题 ， 但 一 运行 〈 用 鼠标 右键 点 击 测试 项 目 HelloBugbenTest， 在 “Run As” 中 选择 “Android JUnit Test" ) ， 就 会 报错 ， 如 图 4-15 所 示 。 





$ Package Explorer gfu JUnit X 
db T p? A: | Q, ges a 


Finished after 0.208 seconds 
Runs: 3/3 E Errors: 3 Failures: 0 


日 Bit] lenovo-lenovo_k910-aaf67ffc [Runner: JUnit 3] (0.078 s) 
zs com.xuben.hellobugben2.test.HelloBugbenTestBase (0.078 s) 
f] testSetBold (0,000 s) 
E testSetSize (0.031 s) 











4-15 运行 结果 








THOME l 1 这 …… 这 是 为 什么 呢 ? ? ? 


$9... 我 保证 不 打 死 你 ! 


4.6 Instrumentation 的 今生 : 对 Android 系 统 的 高 度 控 制 


Ra, 你 打 死 我 之 前 我 能 不 能 知道 为 什么 ? 


2 Jue, 因为 空 指针 异常 啊 ， 策 蛋 ! 


“ 空 指针 异常 ” (NullPointerExeption) ， 如 图 4-16 所 示 。 





三 Failure Trace 


9 java.lang.NullPointerException 
at android. app. Activity .FindViewById(Activity.java:1884) 
at com.xuben. hellobugben2.test.HelloBugbenTestBase. setUp(HelloBugbenTestBase. java:36) 


at android.test. AndroidTestRunner.runTest(AndroidTestRunner.java:191) 

at android. test. AndroidTestRunner.runTest(AndroidTestRunner. java: 176) 

at android.test. InstrumentationTestRunner.onStart(InstrumentationTestRunner.java:554) 
at android. app. Instrumentation$InstrumentationThread.run(Instrumentation. java: 1701) 





图 4-16” 空 指针 异常 


为 什么 会 出 现 空 指针 异常 ? 











因为 测试 用 例 所 调用 的 控件 TextView 是 通过 findViewByld() 方 法 获取 的 ， 如 代码 清单 4-19 所 示 。 


代码 清单 4-19 ”控件 获取 





textviewl = (TextView) findViewById(R.id.myTextView01) ; 
textview2 = (TextView) findViewById(R.id.myTextView02) ; 





而 findViewByld() 方 法 是 Android 框 架 专 有 的 ，JUnit 无 法 获取 。 


人才 那 上 述 代 码 应 该 如 何 修改 ? 


首先 ， 引 入 ActivitylnstrumentationTestCase2， 如 代码 清单 4-20 所 示 。 








代码 清单 4-20 ActivitylnstrumentationTestCase2 





import android.test.ActivityInstrumentationTestCase2; 























其 次 ，HelloBugbenTestBase 继 承 自 ActivitylnstrumentationTestCase2<HelloBugbenActivity> 类 ， 如 代码 清单 4-21 所 示 。 


代码 清单 4-21 ”继承 关系 





public class HelloBugbenTestBase extends 
ActivityInstrumentationTestCase2<HelloBugbenActivity> { 
} 





第 三 , 将 Test suite() 方 法 改 为 HelloBugbenTestBase() 方 法 ， 如 代码 清单 4-22 所 示 。 


代码 清单 4-22 HelloBugbenTestBase() 





public HelloBugbenTestBase() { 
super (HelloBugbenActivity.class); 
// TODO Auto-generated constructor stub 

















第 四 ， 在 setUp() 方 法 中 通过 getActivity() 方 法 即 可 获取 待 测 项 目 HelloBugbenActivity 的 实例 ， 并 通过 该 实例 获取 textview1 和 textview2 两 个 控件 ， 如 代码 清单 4-23 所 示 。 


代码 清单 4-23 ”控件 获取 





GOverride 
public void setUp() throws Exception( 

super.setUp(); 
// xuben: 重点 在 这 里 ， 可 以 获取 被 测 的 HelloBugbenActivity 
hellobugben = getActivity(); 
// xuben: 如 此 一 来 就 可 以 获取 这 两 个 该 死 的 TextView 了 
textviewl = (TextView)hellobugben.findViewById (R.id.myTextView01) ; 
textview2 = (TextView)hellobugben.findViewById (R.id.myTextView02); 
// xuben: 创建 属于 主线 程 的 handler 
handler = new Handler(); 














第 五 ， 第 一 个 测试 用 例 : 控件 文本 设置 测试 (testSetTxtQ) ， 眼 尖 的 同学 发 现 这 里 启动 了 新 线程 ， 这 个 稍 后 详 述 ， 如 代码 清单 4-24 所 示 。 

















代码 清单 4-24 ”启动 新 线程 





// xuben: 控件 文本 设置 测试 
public void testSetTxt() { 
// xuben: 启动 新 线程 进行 控件 文本 设置 
new Thread(){ 
public void run() { 
handler.post (runnableTxt) ; 
} 
].start 0; 
// xuben: 获取 textview1 控 件 文本 
String cmpTxt = textviewl.getText ().toString(); 
// xuben: 将 获取 文本 与 设置 文本 进行 对 比 
assertTrue (cmpTxt.compareToIgnoreCase (bugben txt) == 0); 














六 ， 第 二 个 测试 用 例 : 控件 文本 属性 设置 测试 (testSetBold() ， 如 代码 清单 4-25 所 示 。 


代码 清单 4-25 ”控件 文本 属性 设置 测试 





// xuben: 控件 文本 属性 设置 测试 

public void testSetBold() { 
// xuben: 设置 控件 属性 : 加 粗 
hellobugben.setTv1Bold (bugben bold); 
// xuben: 获取 textviewl 控 件 属性 
TextPaint tp = textviewl.getPaint (); 
Boolean cmpBold = tp.isFakeBoldText (); 
// xuben: 获取 的 属性 应 为 true (加 粗 ) 
assertTrue (cmpBold); 


























第 七 ， 第 三 个 测试 用 例 : 控件 文本 大 小 设置 测试 (testSetSize0) ， 如 代码 清单 4-26 所 示 。 





代码 清单 4-26 ”控件 文本 大 小 设置 测试 





// xuben: 控件 文本 大 小 设置 测试 
public void testSetSize() { 
// xuben: 设置 控件 文本 大 小 
hellobugben.setTv2Size (bugben size); 
// xuben: 获取 textview2 控 件 文本 大 小 
Float cmpSize = textview2.getTextSize(); 
// xuben: 将 获取 文本 与 输入 文本 进行 对 比 
assertTrue (cmpSize.compareTo (bugben_size) == 0); 





完整 代码 ， 如 代码 清单 4-27 所 示 。 


代码 清单 4-27 ”完整 代码 





package com.xuben.hellobugben.test; 
import com.xuben.hellobugben.hellobugben; 
import com.xuben.hellobugben.R; 
import android.os.Handler; 
import android.test.ActivityInstrumentationTestCase2; 
import android.text.TextPaint; 
import android.util.Log; 
import android.widget.TextView; 
public class HelloBugbenTestBase extends ActivityInstrumentationTestCase2<hellobugben> 
{public HelloBugbenTestBase() { 
super (hellobugben.class) ; 
// TODO Auto-generated constructor stub 


hellobugben hellobugben; 

private Handler handler - null; 

private TextView textviewl; 

private TextView textview2; 

String bugben txt = "bugben"; 

Boolean bugben bold - true; 

Float bugben size - (float) 20.0; 

Float value; 

GOverride 

public void setUp() throws Exception( 
super.setUp(); 
// xuben: 重点 在 这 里 ， 可 以 获取 被 测 的 HelloBugbenActivity 
hellobugben = getActivity(); 
// xuben: 如 此 一 来 就 可 以 获取 这 两 个 该 死 的 TextView 了 
textviewl = (TextView)hellobugben.findViewById (R.id.myTextView01); 
textview2 -(TextView)hellobugben.findViewById (R.id.myTextView02); 
// xuben: 创建 属于 主线 程 的 handler 
handler = new Handler(); 

} 

GOverride 

public void tearDown() throws Exception( 
super.tearDown(); 


l 
// xuben: 控件 文本 设置 测试 
public void testSetTxt() ( 
// xuben: 启动 新 线程 进行 控件 文本 设置 
new Thread(){ 
public void run() { 
handler.post (runnableTxt) ; 
} 
).start(); 
// xuben: 获取 textviewl 控 件 文本 
String cmpTxt = textviewl.getText ().toString(); 
// xuben: 将 获取 文本 与 设置 文本 进行 对 比 
assertTrue (cmpTxt.compareToIgnoreCase (bugben txt) == 0); 


l 

// xuben: 控件 文本 属性 设置 测试 

public void testSetBold() ( 
// xuben: 设置 控件 属性 : 加 粗 
hellobugben.setTv1Bold (bugben bold); 
// xuben: 获取 textview1 控 件 属 性 
TextPaint tp = textviewl.getPaint(); 
Boolean cmpBold = tp.isFakeBoldText (); 
// xuben: 获取 的 属性 应 为 true (加 粗 ) 
assertTrue (cmpBold) ; 


l 
// xuben: 控件 文本 大 小 设置 测试 
public void testSetSize() { 
// xuben: 设置 控件 文本 大 小 
hellobugben.setTv2Size (bugben size); 
// xuben: 获取 textview2 控 件 文本 大 小 
Float cmpSize = textview2.getTextSize(); 
// xuben: 将 获取 文本 与 输入 文本 进行 对 比 
assertTrue (cmpSize.compareTo (bugben_size) == 0); 


} 
// xuben: 构建 Runnable 对 象 ， 在 runnable 中 设置 文本 
Runnable runnableTxt = new Runnable(){ 
GOverride 
public void run() { 
// xuben: 设置 控件 文本 
hellobugben.setTxt (bugben txt); 


HN 





用 鼠标 右键 点 击 测试 项 目 HelloBugbenTest， 在 “Run As" HE "Android JUnit Test” 运 行 。 
B aka 失败 的 话 我 想 我 也 是 醉 了 …… 


Oaa, x 大 副 ， 要 对 奔 哥 有 信心 ! 


运行 结果 ， 如 图 4-17 所 示 。 





I Package Explorer (gjë JUnit 52 | = 6 


[Sg mü- v 


Finished after 1.482 seconds 
Runs: B Eros: 0 BFaluwes: DO 


 lenovo-lenovo, k910-aaf67ffc [Runner: JUnit 3 ) 

Gee] r^ xuben.hellobugben2. test. rey sre oe (1. 629 s) 
-HEj testSetBold (0.543 s) 

gE] testSetSize (0.466 s) 


testSetTxt (0.620 s) 





图 4-17 运行 结果 


F amaii 


4. Instrumentation 前 世 今生 分 析 


可是， 为 什么 要 这 样 修改 呢 ? 


ActivityInstrumentationTestCase2 又 是 个 什么 东 东 呢 ? 为 什么 有 个 2 呢 ? 难道 它 比 较 二 ? 


eo 事实 上 ， 作 为 继承 者 ，ActivityInstrumentationTestCase2 的 继承 结构 如 下 图 所 示 





ActivitylnstrumentationTestCase2 继 承 结构 ， 如 图 4-18 所 示 。 


java.lang.Object 
Ljunit framework Assert 
Ljunit framework TestCase 


Landroid test InstrumentationTestCase 


Landroid test ActivityTestCase 
Landroid.test ActivityInstrumentationTestCase2«T extends android app.Activity- 








4-18  ActivityInstrumentationTestCase2 4E 7 25 44] 











ActivitylnstrumentationTestCase2 人 允许 InstrumentationTestCase.launchActivity 来 启动 被 测试 的 Activity。 而 且 ，ActivitylnstrumentationTestCase2 还 支持 在 UI 线 程 中 运行 测试 方法 ， 并 能 
Intent 对 象 到 被 测试 的 Activity 中 。 这 样 一 来 ， 我 们 就 能 直接 操作 被 测试 的 Activity 了 。 


也 正 因为 ActivitylnstrumentationTestCase2 有 如 此 出 众 的 优点 ， 它 才能 取代 了 比 他 早出 世 的 哥哥 : ActivitylnstrumentationTestCase， 成 为 了 Instrumentation 测 试 的 基础 。 





了 解 了 ActivitylnstrumentationTestCase2， 我 们 就 知道 刚才 修改 的 用 意 : 通过 继承 ActivitylnstrumentationTestCase2 来 获取 并 操作 被 测试 的 Activity 中 的 控件 (这 里 是 TextView) ， 如 此 一 来 ， 就 不 
会 再 报 出 “ 空 指针 异常 ” (NullPointerExeption) F. 








Se .， ， 让 我 们 更 多 地 了 解 一 下 Instrumentation 测 试 的 特点 。 继 承 关 系 如 图 4-19 所 示 。 








Instrumentation 继 承 关 系 ， 如 图 4-19 所 示 。 
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作为 执行 application Instrumentation 代 码 的 基 类 ，Instrumentation 将 在 所 有 应 用 程序 运行 前 初始 化 ， 可 以 通过 它 监测 系统 与 应 用 程序 之 间 的 交互 。 



































大 家 是 否 还 记得 在 《Instrumentation 的 前 世 》 那 一 节 里 ， 我 们 建立 测试 项 目 后 ， 打 开 其 AndroidManifest.xml， 发 现 其 包含 <Instr umentation> 标 签 ， 并 自动 将 待 测 项 目的 包 
“com.xuben.hellobugben” 设 为 其 targetPackage， 如 代码 清单 4-28 所 示 。 




















代码 清单 4-28 AndroidManifest.xml 





<?xml version-"1.0" encoding-"utf-8"?» 

«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com. xuben.hellobugben.test" 
android:versionCode-"1" 
android:versionName-"1.0" > 
«uses-sdk android:minSdkVersion-"10" /» 

XInstrumentation 
android:name-"android.test.InstrumentationTestRunner" 
android:targetPackage-"com.xuben.hellobugben" /» 

«application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app name" > 
<uses-library android:name-"android.test.runner" /» 

</application> 


«/manifest» 



































Instrumentation implementation 就 是 通过 的 AndroidManifest.xml 中 的 <Instrumentation> 标 签 元 素来 指定 要 测试 的 应 用 程序 ， 这 个 元 素 指定 被 测 应 用 包 名 (BD "com.xuben.hellobugben" ) 及 
如 何 运 行 测试 程序 。 
































Instrumentation 可 以 提供 单元 测试 及 功能 级 的 自动 化 测试 ， 可 以 通过 调用 Android SDK 提 供 的 测试 API 设 计 测 试用 例 ， 我 们 创建 的 测试 用 例 将 以 APK 的 方式 直接 安装 到 设备 上 ， 并 在 设备 上 控制 、 运 行 
及 验证 被 测 应 用 。 



























































5 





全 这 样 做 有 什么 好 处 呢 ? 


测试 程序 (TestApp) 与 被 测 程序 (TargetApp) 处 于 同一 进程 的 不 同 线程 中 (ActivityInstrumentationTestCase2 支 持 在 UI 线程 中 运行 测试 方法 ) ， 通 过 Instrumentation 进 行 交互 。 这 样 一 来 ， 我 们 
仅 需 在 PC 端 通过 命令 即 可 控制 Instrumentation 执 行 测试 用 例 ， 并 返回 测试 结果 。 

















小 插曲 : 启动 新 线程 进行 测试 





dp, 对 之 前 的 代码 我 还 有 一 个 问题 : 为 什么 控件 文本 设置 测试 (testSetTxt0) 这 个 用 例 需 要 启动 新 线程 呢 ? 


Mas 问 到 点 子 上 了 : 因为 另外 两 个 方法 都 是 通过 TextPaint 对 控件 进行 操作 。 





设置 属性 ， 如 代码 清单 4-29 所 示 。 





代码 清单 4-29 ”设置 属性 





public void setTvlBold (Boolean bold) { 
TextPaint tp = textviewl.getPaint(); 
tp.setFakeBoldText (bold); 

} 

public void setTv2Size(Float size) { 
TextPaint tp = textview2.getPaint(); 
tp.setTextSize (size); 

} 





BS o 方法 则 是 对 控件 进行 直接 操作 。 


设置 文本 如 代码 清单 4-30 所 示 。 





代码 清单 4-30 ”设置 文本 





public void setTxt (String txt) { 
textviewl.setText (txt); 
textview2.setText (txt); 





EC] 
< 全 % 如 果 直 接 进 行 测试 ， 不 启动 新 线程 ， 会 怎么 样 ? 
89... 


如 果 直 接 进 行 测试 ， 不 启动 新 线程 ， 如 代码 清单 4-31 所 示 。 








代码 清单 4-31 不 启动 新 线程 直接 测试 





public void testSetTxt() { 
/ xuben: 设置 控件 文本 
hellobugben.setTxt (bugben txt); 
// xuben: 获取 textview1 控 件 文 本 
String cmpTxt = textviewl.getText ().toString(); 
// xuben: 将 获取 文本 与 设置 文本 进行 对 比 
assertTrue (cmpTxt.compareToIgnoreCase (bugben txt) 一 0); 








SRR, AATE! 





运行 报错 ， 如 图 4-20 所 示 。 











ts Package Explorer go JUnit Z3 — H 


Finished after 1.383 seconds 


Runs: 3/3 B Errors: 1 Failures: 0 


日 fie) lenovo-lenovo, k910-aaf67ffc [Runner: JUnit 3] (1.389 s) 
EB com.xuben.hellobugben2.test.HelloBugbenTestBase (1.389 s) 


: EE) testSetBold (0.406 s) 


Bk] testSetSize (0.452 s) 
EK) testSetTxt (0.531 s) 


* 





图 4-20 运行 结果 


fe 
人 果然， 这 是 什么 原因 呢 ? 





查看 原因 ， 如 图 4-21 所 示 。 














= Failure Trace 


Ü android. view. ViewRootImpl$CalledFromwWrongThreadException: Only the original thread that created a view hierarchy can 
at android. view. ViewRootImpl.checkThread(ViewRootImpl.java:6172) 
at android. view. ViewRootImpl.invalidateChildInParent(ViewRootImpl.java:882) 
at android. view. ViewGroup. invalidateChild(ViewGroup. java:4320) 
at android. view. View. invalidate(View. java: 10935) 
at android, view. View. invalidate(View. java: 10890) 
at android. widget. TextView. checkForRelayout(TextView. java: 7045) 
at android. widget. TextView.setText(TextView.java:4193) 
at android. widget. TextView.setText(TextView.java:4045) 
at android. widget. TextView.setText(TextView.java:4020) 
at com.xuben.hellobugben2.HelloBugbenActivity2.setTxt(HelloBugbenActivity2.java:33) 
at com.xuben, hellobugben2.test.HelloBugbenTestBase.testSetTxt(HelloBugbenTestBase. java:60) 
at android. test. InstrumentationTestCase. runMethod(InstrumentationTestCase. java:214) 
at android. test. InstrumentationTestCase.runTest(InstrumentationTestCase. java: 199) 
at android. test. ActivityInstrumentationTestCase2.runTest(ActivityInstrumentationTestCase2. java: 192) 
at android. test. AndroidTestRunner .runTest(AndroidTestRunner.java:191) 
at android.test. AndroidTestRunner.runTest(AndroidTestRunner java: 176) 
at android. test. InstrumentationTestRunner.onStart(InstrumentationTestRunner. java:554) 
at android. app. Instrumentation$InstrumentationThread.run(Instrumentation, java:1701) 








4-21 ”线程 安全 问题 














原因 为 : android.view.ViewRootlmpl$CalledFromWrongThreadException:Only the original thread that created a view hierarchy can touch its views, 


$e 
全 如果 我 说 看 不 懂 ， 你 是 不 是 也 醉 了 ? 


Google 一 下 ， 原 来 Android 中 相关 的 view 和 控件 不 是 线程 安全 的 ， 必 须 单独 做 处 理 。 





所 以 ， 需 要 启动 新 线程 进行 处 理 ， 具 体 步 又 如 下 。 


1) 在 setUp() 方 法 中 创建 Handler 对 象 ， 如 代码 清单 4-32 所 示 。 


代码 清单 4-32 创建 Handler 对 象 





GOverride 
public void setUp() throws Exception( 
super.setUp(); 
// xuben: 创建 属于 主线 程 的 handler 
handler = new Handler(); 





2) 创建 Runnable 对 象 ， 在 Runnable 中 进行 控件 文本 设置 ， 如 代码 清单 4-33 所 示 。 


代码 清单 4-33 ”控件 文本 设置 





// xuben: 构建 Runnable 对 象 ， 在 runnable 中 设置 文本 
Runnable runnableTxt = new Runnable()( 
GOverride 
public void run() { 
// xuben: 设置 控件 文本 
hellobugben.setTxt (bugben txt); 
} 








3) 在 具体 测试 方法 中 通过 调用 runnable 对 象 实现 文本 设置 ， 如 代码 清单 4-34 所 示 。 


代码 清单 4-34 ”启动 新 线程 





// xuben: 启动 新 线程 进行 控件 文本 设置 
new Thread(){ 
public void run(){ 
handler.post (runnableTxt); 


} 
}.start (); 





重新 运行 ， 结 果 如 图 4-22 所 示 。 
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Finished after 1.482 seconds 


Runs: 3/3 Errors: O B Failures: 0 


Se eS eee a 
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Ate com .xuben.hellabugben?2 test. HelloBugbenTestBase (1.629 s) 
---BE] testsetBold (0.543 s) 


LB] testsetSize (0.466 s) 


BE] testsetTxt (0.620 s) 

















4-02 ”运行 正常 


SORT ERT! 做 自动 化 测试 可 真是 件 杀 脑 细胞 的 事 啊 ! 


4.8 第 六 个 Impossible Mission 


69, 刚 接 到 通知 ， 程 序 员 们 再 次 更 新 了 代码 ! 
全 % 额 ， 他 们 还 想 不 想 继续 愉快 地 玩 要 了 ? 


前 面 通过 对 bugben 项 目的 分 析 ， 我 们 逐步 认识 了 Instrumentation 的 前 世 今 生 一 一 即 如 何 对 项 目 进行 JUnit 测 试 和 Instrumentation 测 试 ， 并 了 解 了 Instrumentation 的 基本 原理 。 


但 是 ,真正 的 自动 化 可 没 这 么 简单 ， 不 会 仅仅 放 几 个 方法 让 你 做 做 单元 测试 (如 果 只 是 对 方法 的 测试 ， 那 也 谈 不 上 是 自动 化 测试 ) ， 一 般 而 言 ， 自 动 化 都 会 涉及 用 户 交互 ， 比 如 定位 、 输 入 、 点 击 , 复 
杂 的 还 有 长 按 、 拖 搜 和 翻 页 等 。 


随 着 我 们 学 习 的 深入 ， 这 个 项 目 也 在 不 断 地 成 长 、 发 展 、 壮 大 ， 现 在 ， 项 目的 主 界面 变 成 了 本 书 开头 所 展示 的 那样 。 














1) 进入 Bugben 应 用 ， 如 图 4-23 所 示 。 











2) 进行 输入 和 选择 后 点 击 “ 提 交 ” 按 钮 ， 如 图 4-24 所 示 。 





3) 上 点击“ 提交” 按钮 ， 运 行 结果 ， 如 图 4-25 所 示 。 
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4-23 进入 Bugben 应 用 
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4-25 运行 结果 





人 现在， 我 们 终于 可 以 一 罕 这 个 项 目的 源码 了 ! 来 吧 ， 让 我 们 看 个 究竟 ! 


49 Instrumentation 自 动 化 脚本 开发 


Oy, 这 里 涉及 控件 调用 ， 需 要 满足 3 个 条 件 ， 你 知道 是 哪 3 个 吗 ? 


SARI RENAL AFT, AKC! 


既然 要 对 这 个 更 大 强大 的 HelloBugben 项 目 进行 自动 化 测试 ， 必 须要 满足 以 下 3 个 条 件 。 
1) 获取 Activity 控 件 的 能 力 : 如 果 获 取 不 了 控件 ， 就 谈 不 上 去 控制 它们 。 
2) 调用 Activity 控 件 的 能 力 : 如 果 没 办 法 调用 控件 ， 那 就 没 办 法 操作 它们 。 


3) 对 结果 的 断言 的 能 力 : 如 果 没 法 对 结果 做 判断 ， 那 自动 化 的 意义 也 就 不 存在 了 。 


eo, us. 我 们 就 大 体 知道 Instrumentation 的 自动 化 该 从 何 处 下 手 了 。 




















1) 获取 Activity 控 件 的 能 力 : 通过 调用 Android SDK 自 带 的 HierarchyViewer 工 具 获 取 控件 ID。 




















2) 调用 Activity 控 件 的 能 力 : 通过 调用 View 的 相应 的 Action 方 法 调用 控件 。 

















3) 对 结果 的 断言 的 能 力 : 通过 Assert 对 结果 进行 断言 。 
4.9.1 Instrumentation 自 动 化 条 件 


2°, 解 了 这 些 ， 让 我 们 先 来 看 看 这 个 项 目的 代码 。 


我 们 发 现 项 目 文件 结构 发 生变 化 ， 如 图 4-26 所 示 。 








com.xuben.helloabugben 

[J) ChangeActiviby. java 
J) HelloBuabenActivity.jav. 
+) BA Android 4.2.2 





CT | 





| 9-2 gen [Generated Java Files] 
| PF cS assets 


让 Sb, hin 


cunt L mn aan " 
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El res 


E 


| E drawable-hdpi 
EE H-E drawable-Idpi 
| | H-E drawable-mdpi 
S-E layout 
|. [X] display.xml 
= | | [X] main.xml 
B-S values 
的 font. xml 
o] [X] strings. xml 


AndroidManifest, xml 
lint. xml 
proguard.cfg 
project.properties 


图 4-26 ”HelloBugben 项 目 文件 结构 





E sae TIRE, ER TRE RENT RRA RATE 
增加 的 文件 如 下 。 

1) src 下 多 了 一 个 名 为 com.xuben.change 的 包 ， 包 括 一 个 Changejava 文 件 。 
2) 在 原 有 的 com.xuben.hellobugben 下 也 增加 了 一 个 ChangeActivityjava 文 件 。 
3) 在 res 下 面 ，layout 增 加 一 个 displayxm[ 文 件 。 

E ee, ban A HUP 

先 来 看 看 ChangeActivityjava 文 件 ， 如 代码 清单 4-35 所 示 。 


代码 清单 4-35 ChangeActivityjava 





Pp e com.xuben.hellobugben; 


import com.xuben.change.Change; 
import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.View; 
import android.view.View.OnClickListener; 
import android.widget.Button; 
import android.widget.EditText; 
import android.widget.RadioButton; 
public class ChangeActivity extends Activity 
{ 
GOverride 
public void onCreate (Bundle savedInstanceState) 
{ 
super .onCreate (savedInstanceState) ; 
setContentView (R.layout.main); 
Button subButton = (Button) findViewById(R.id.myButton01) ; 
subButton.setOnClickListener (new OnClickListener () 
{ 
GOverride 
public void onClick(View v) 
{ 
// xuben: 获取 提交 数据 
EditText txtl = (EditText) findViewById (R.id.txtl); 
EditText txt2 = (EditText) findViewById (R.id.txt2); 
RadioButton bold = (RadioButton) findViewById(R.id.bold) ; 
RadioButton small = (RadioButton) findViewById (R.id.small); 
// xuben: 获取 用 户 输入 
String textl = txtl.getText ().toString(); 
String text2 = txt2.getText ().toString(); 
String isBold = bold.isChecked() ? "bold" : "notbold"; 
String wordSize = small.isChecked() ? "small" : "big"; 
// xuben: 将 用 户 输 入 创建 为 可 序列 化 对 象 change 
Change change = new Change(textl, text2, isBold, wordSize); 
// xuben: 通过 Bundle 将 可 序列 化 对 象 change 传 
// i%#HelloBugbenActivity 
Bundle data = new Bundle(); 
data.putSerializable ("change", change); 
Intent intent - new Intent (ChangeActivity.this 
, HelloBugbenActivity.class); 
intent.putExtras (data); 
startActivity (intent); 


n; 


OS cna, 它 对 应 的 就 是 项 目的 主 界面 ， 即 用 户 提交 界面 。 


该 界面 由 两 个 文字 输入 框 (txt1 和 txt2) 、 两 个 粗细 选项 框 (bold 和 notbold) 、 两 个 字号 选项 框 (small 和 big) 、 还 有 一 个 提交 按钮 subButton 组 成 。 





























当 点 击 “ 提 交 ” 按 钮 时 ， 将 触发 点 击 事件 ， 将 用 户 输入 传 给 可 序列 化 对 象 change， 并 通过 Bundle 将 可 序列 化 对 象 change 传 递 给 显示 界面 HelloBugbenActivity 进 行 显示 ， 而 HelloBugbenActivity 显 示 
的 内 容 即 为 之 前 的 项 目 所 展示 的 效果 。 





























这 样 一 来 ， 我 们 大 体 明 白 ， 新 增 的 ChangeActivity 作 为 提交 界面 而 存在 ， 用 户 输入 后 需要 将 数据 打包 一 下 传 给 HelloBugbenActivity 进 行 显示 ， 而 Change 则 提供 了 用 以 将 数据 打包 的 对 象 。 






































理解 了 这 点 ， 再 看 Change.java 就 一 目 了 然 了 ， 如 代码 清单 4-36 所 示 。 


代码 清单 4-36 Change.java 





package com.xuben.change; 
import java.io.Serializable; 
public class Change implements Serializable 
{ 
private static final long serialVersionUID = 1L; 
private Integer id; 
private String txtl; 
private String txt2; 
private String isBold; 
private String wordSize; 
public Change () 
{ 


l 
// xuben: Change 对 象 就 是 一 个 包 ， 用 以 设置 与 获取 文本 框 文字 和 选择 的 颜色 
public Change (String txtl, String txt2, String isBold, String wordSize) 
{ 
this.txtl = txtl; 
this.txt2 = txt2; 
this.isBold - isBold; 
this.wordSize = wordSize; 


f 
public Integer getId() 
{ 


return id; 


public void setId(Integer id) 


{ 
this.id = id; 


l 
public String getText1 () 
{ 


} 
public void setTextl(String txt) 
{ 


return txtl; 


this.txtl = txt; 
public String getText2 () 
: return txt2; 
apio void setText2 (String txt) 


this.txt2 - txt; 


} 
public String getBold() 
{ 


return isBold; 


public void setBold(String isBold) 
{ 
this.isBold = isBold; 


public String getwordSize () 
{ 


return wordSize; 


public void setwordSize (String wordSize) 


{ 


this.wordSize = wordSize; 











去 为 什么 要 专门 设计 这 样 一 个 可 序列 化 对 象 类 呢 ? 


$9. nns: 因为 结果 显示 界面 马上 就 要 调用 它 。 
HelloBugbenActivityjava， 如 代码 清单 4-37 所 示 。 


代码 清单 4-37 HelloBugbenActivity.java 





package com.xuben.hellobugben; 
import com.xuben.change.Change; 
import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.text.TextPaint; 
import android.widget.TextView; 
public class HelloBugbenActivity extends Activity { 
private TextView textviewl; 
private TextView textview2; 
// xuben: 对 应 选项 
Boolean bugben bold = true; 
Boolean bugben notbold - false; 
Float bugben small size = (float) 60.0; 
Float bugben big size = (float) 180.0; 
GOverride `  . 
public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R.layout.display); 
textviewl = (TextView) findViewById(R.id.myTextView01) ; 
textview2 = (TextView) findViewById(R.id.myTextView02) ; 
// xuben: 取出 提交 的 文本 和 属性 信息 
Intent intent = getIntent(); 
Bundle data = intent.getExtras(); 
Change change - (Change)data.getSerializable ("change"); 
// xuben: 设置 文本 框 1 和 文本 框 2 的 文字 
textviewl.setText (change.getText] () 
textview2.setText (change.getText2 () 
// xuben: 设置 文本 框 1 加 粗 与 否 
if (change.getBold() .equalsIgnoreCase ("bold") ) { 
TextPaint tp = textviewl.getPaint () 7 
tp.setFakeBoldText (bugben bold); 


i 
); 


} 

else if(change.getBold().equalsIgnoreCase ("notbold") ){ 
TextPaint tp = textviewl.getPaint(); 
tp.setFakeBoldText (bugben_notbold) ; 


} 

// xuben: 设置 文本 框 2 的 大 小 

if (change.getwordSize() .equalsIgnoreCase ("small") ) { 
TextPaint tp = textview2.getPaint (); 
tp.setTextSize(bugben small size); 


else if (change.getwordSize() .equalsIgnoreCase ("big") ) { 
TextPaint tp = textview2.getPaint(); 
tp.setTextSize (bugben_big size); 








不 知道 大 家 注意 到 没有 ，HelloBugbenActivity 设 置 两 个 文本 框 的 文字 、 属 性 和 大 小 等 ， 都 是 通过 change.getText10、change.getText2(、change.getBold0 和 change.getwordSize() 等 进行 获取 
这 就 是 设计 这 个 对 象 类 的 目的 所 在 。 








当 项 目 代码 清晰 后 ， 那 对 应 的 资源 文件 也 就 清晰 了 : main.xml 对 应 的 不 再 是 项 目的 显示 界面 ， 而 是 提交 界面 ， 如 代码 清单 4-38 所 示 。 





代码 清单 4-38 main.xml 





<?xml version-"1.0" encoding-"utf-8"?» 

<TableLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width-"fill parent" 
android:layout height-"fill parent" 
> 








<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
android:text=" 请 在 下 框 中 输入 希望 修改 的 文字 : " 
android:textSize="20sp" 
/> 

<TableRow> 

<TextView 
android:layout width-"fill parent" 
android:layout height-"wrap content" 





android:text-" X Kjglx F : " 
android:textSize-"16sp" 
/> 
<!-- 文本 框 1 文字 输入 --> 
<EditText 


android: id="@+id/txt1" 
android: layout_width="fill parent" 
android: layout_height="wrap_ content" 
android:hint-"Bugbenfit4i: 巴 哥 奔 " 
android:selectAllOnFocus-"true" 
/> 

</TableRow> 

<TableRow> 

<TextView 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:text-" X KjE2x y: " 
android:textSize-"16sp" 





/> 

<!-- 文本 框 2 文字 输入 -— 

<EditText 
android: id="@+id/txt2" 
android: layout_width="fill parent" 
android: layout height-"wrap content" 
android:hint="BugbenQQ: 197 1629467" 
android: selectAl10nFocus="true" 
/> 

</TableRow> 

<TextView 
android: layout_width="fill parent" 
android: layout_height="wrap_content" 
android:text=" 请 选择 文字 属性 : OU 
android:textSize-"20sp" 
/> 

<TableRow> 

<TextView 
android: layout_width="fill parent" 
android:layout height-"wrap content" 
android:text- 

















"文本 框 1 粗细 : " 
android:textSize="16sp" 


/> 
<!-- 文本 框 1 大 小 选择 --> 
<RadioGroup 


android:layout width-"fill parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal" 

> 

<RadioButton 
android: id="@+id/bold" 
android:layout width-"wrap content" 


android:layout height-"wrap content" 
android: text=" Jo41" 
android:textSize="16sp" 


/> 

<RadioButton 
android: id="@+id/notbold" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-' f jen" ~ 
android: textSize="16sp" 

/> 

</RadioGroup> 

</TableRow> 

<TableRow> 

<TextView 


android: layout_width="fill parent" 
android: layout height-"wrap content" 
android:text-" X KJE2X: "7 
android:textSize-"1l6sp" 


/> 

<!-- 文本 框 2 大 小 选择 --> 

<RadioGroup 
android: layout_width="fill parent" 
android: layout height-"wrap content" 
android:orientation-"horizontal" 


> 

<RadioButton 
android: id="@+id/smal1" 
android: layout width-"wrap content" 
android:layout height-"wrap content" 
android:text=" 小 号 " 
android:textSize-"16sp" 

/> 

<RadioButton 
android: id="@+id/big" 
android: layout width-"wrap content" 
android:layout height-"wrap content" 
android:texte" X 5" 
android:textSize-"16sp" 

/> 

«/RadioGroup» 

«/TableRow» 

«Button 
android: id="@+id/myButton01" 
android: layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"j£ x" 
android:textSize-"1l6sp" 

{> 

</TableLayout> 





Se 
ST, 项 目 清楚 了 ， 接 下 来 让 我 们 对 这 个 项 目 进行 自动 化 测试 吧 ! 


4.9.2 ”捕获 最 初 项 目 控件 


件 ， 





既然 具备 了 自动 化 的 3 个 基本 条 件 ， 下 面 就 一 起 尝试 着 对 之 前 项 目 进行 简单 的 自动 化 测试 吧 ! 


首先 ， 我 们 需要 捕获 这 两 个 界面 的 控件 ID。 





E 


ACT LARA SERE RU"? 项 目 源码 里 所 有 控件 ID 不 都 清 清楚 楚 列 在 那里 吗 ? 为 什么 还 要 对 其 进行 捕获 ? 


Oi 因为 在 实际 工作 中 ， 自 动 化 测试 工程 师 与 研发 工程 师 往 往 不 在 一 个 团队 。 


自动 化 测试 工程 师 也 不 像 单 元 测试 工程 师 那 样 拥有 强大 的 项 目 代码 读 写 权 限 ， 更 何况 很 多 测试 场景 所 涉及 的 应 用 、 界 面 或 控件 是 外 部 的 ， 更 别 指望 获取 项 目 源码 了 。 








E" 





























要 的 是 ， 实 际 工作 中 待 测试 的 项 目 往往 巨大 无 比 ， 就 算 通 过 各 种 手段 合 到 项 目 源码 ， 为 了 获取 某 个 控件 ID 而 导入 整个 项 目 显然 是 不 明智 且 效 率 低下 的 。 

















正 因为 如 此 ， 我 们 需要 掌握 一 些 快速 捕获 控件 ID 的 工具 ， 对 于 自动 化 工程 师 而 言 这 点 尤其 重要 。 下 面 以 Android 官 方 推荐 的 控件 ID 捕获 工具 (HierarchyViewer) 为 例 进行 讲解 。 





























将 手机 连接 到 PC， 打 开 Android 4.2 的 SDK 文 件 夹 ， 在 tools 目 录 下 : 





























HierarchyViewer 工 具 就 打开 了 。 




















因为 此 时 手机 界面 为 HelloBugben 项 目 界面 ( 见 





到 4-23) ， 所 以 HierarchyViewer 将 自动 识别 控件 节点 树 ， 











“~\android-sdk-WindowsX.X\tools” (tt 








是 monkeyrunner.bat 的 同 级 目录 ) 找到 hierarchyviewer.bat， 双 击 该 批 处 理 文 














展现 如 图 





4-27 所 示 。 


s= Hierarchy Viewer 


MSM8625QSKUD 
RecentsPanel 
StatusBar 
Keyguard 
com.xuben.hellobugben/com.xuben.hellobugben.ChangeActivity 
com.lenovo.launcher/com.lenovo.launcher2.Launcher 


com.tencent.mmjcom.tencent.mm.ui.conversation.BizConversationUI 
com.tencent.mm/com.tencent.mm.ui.LauncherUI 
com.qq.reader/com.qq.reader.MainActivity 

com. android. systemui. Image Wallpaper 








4-27 








J& Sl HierarchyViewer 








双击 “com.xuben.helloandroid/com.xuben.hellobugben.ChangeActivity”，HierarchyViewer 将 跳 转 到 “tree view” 节 点 树 菜单 ， 如 图 4-28 所 示 。 





左 侧 为 控件 树 ， 右 侧 上 方 控件 树 缩 略 图 ， 右 侧 中 间 为 控件 属性 详情 ， 右 侧 下 方 为 整个 手机 布 





局 。 通 过 鼠标 点 击 左 侧 空白 

















处 可 进行 拖 动 查看 ， 通 过 滚轮 或 选择 左 侧 下 方 比例 条 可 进行 显示 比例 调节 。 


© Hierarchy Viewer E 


Fle Tree View 


H save as PNG | 励 Capture Layers | ==} Load view itera | D Display view | © ivadaetayrou | ^r Request Layout | -zÍ dump Deplaytist | 


E- Accessibility 
Drawing 

H- Events 

E- Focus 
-Layout 

E- Measurement 
E Miscellaneous 
由 -Padding 
Scrolling 

由 .Text 


z| >| 200% 
图 4-28 控件 节点 树 菜 单 


点 击 某 个 控件 ， 比 如 此 处 的 第 一 个 输入 框 ， 我 们 可 以 看 到 左 侧 节点 显示 它 的 控件 ID 为 “txt1” (id/txt1) ， 并 在 上 方 显 示 它 的 提示 信息 为 “Bugeben 微 信 : 
可 以 看 到 ， 它 的 文本 为 空 (表示 目前 还 没有 用 户 输 入 ) ， 如 图 4-29 所 示 。 

















TextView 
@414d0560 





E Measurement 

1 view Miscellaneous 
Measure: 0.053 ms Padding 
ayout: 0.0; E Scrolling 
Draw: 1.342 ms E Text 











getSelectionEnd() 


ji h getSelectionStart() 
TableRow ; EditText getTextAlignment() 
@414d0c40 @414d17d0 | getTextDirection() 


idjtxt1 getTextSize() 
DE Gee 


TextView 
@414dd4a8 








”。 展 开 右 侧 的 控件 属性 详情 ， 我 们 


getResolvedTextAlignment() GRAVITY 


0 

0 
GRAVITY 
INHERIT 
27.0 




















图 4-29 ”控件 属性 详情 


如 果 此 时 用 户 在 界面 上 对 文本 框 1 输入 文本 “小 简洁 ”， 如 图 4-30 所 示 。 


bugben 


请 在 下 框 中 输入 希望 


修改 和 文子 : 





清 选择 文字 属性 : 

VU ASHE |} ji a ^ | 
文本 框 1 粗细 【“) 加 粗 \“) 不 加 粗 
LEHA: 


OLOR 





图 4-30 ”对 文本 框 1 输入 文本 








ai 


刷新 捕获 到 的 界面 ， 得 到 结果 如 图 4-31 所 示 。 

















Measurement 
Miscellaneous 
Padding 
由 Scrolling 
©- Text 
| - getResolvedTextAlignment() GRAVITY 
getSelectionEnd() 3 
+- getSelectionStart() 3 
~~ getTextAlignment() GRAVITY 
getTextDirection() INHERIT 
J +- getTextSize() 27.0 
Z = mText ber 


EditText 
(9414d17d0 
id/ext1 





图 4-31 捕获 到 文本 框 1 文本 内 容 


ee 
《了解 如 何 捕获 控件 后 ， 下 面 咱们 就 来 对 它 进 行 测试 吧 ! 


493 ”对 最 初 项 目的 自动 化 测试 


99, s. 假如 我 们 现在 希望 对 测试 最 初 项 目 进行 自动 化 测试 ， 总 共 分 几 步 ? 


i» 
SL. MR, BIE LF, BRR! 


对 测试 最 初 项 目 进行 自动 化 测试 需要 进行 如 下 几 个 步骤 。 

















1) 启动 应 用 : 启动 bugben 应 用 ， 并 进入 其 主 界面 ， 即 ChangeActivity。 




















2) 编辑 界面 : 输入 文本 框 1 和 文本 框 2， 即 在 textview1 和 textview2 内 输入 文字 并 选择 加 粗 和 大 号 字体 。 





3) 结果 提交 : 点 击 提交 按钮 ， 即 subButton， 将 触发 按钮 事件 进行 数据 传输 。 





4) 界面 跳 转 : 点 击 后 界面 将 从 编辑 界面 ChangeActivity 跳 转 至 结果 显示 界面 HelloBugbenActivity。 

















5) 验证 显示 : 界面 跳 转 后 ，HelloBugbenActivity 将 正确 显示 编辑 界面 所 录入 的 文字 和 选择 的 文字 属性 ， 这 也 即 是 此 项 自动 化 测试 的 验证 点 。 

















基于 此 ， 我 们 可 以 按照 以 上 步骤 开始 自动 化 测试 。 既 然 上 一 节 我 们 知道 如 何 捕获 这 个 控件 ， 下 面 就 一 起 来 看 看 如 何 进行 测试 。 
































1) 启动 应 用 : 启动 bugben 应 用 ， 并 进入 其 主 界面 ， 即 ChangeActivity， 如 代码 清单 4-39 所 示 。 























代码 清单 4-39 ChangeActivity 


// xuben: 启动 ChangeActivity 

Intent intent = new Intent(); 

intent.setClassName ("com.xuben.hellobugben", ChangeActivity.class.getName()); 
intent.setFlags (Intent.FLAG ACTIVITY NEW TASK); 

changeAutoTest =(ChangeActivity) getInstrumentation() .startActivitySync (intent); 











启动 。 








通过 setClassNamel() 方 法 设置 包 名 和 类 名 ， 通 过 setFlags() 方 法 设置 标识 ， 然 后 就 可 以 通过 getlnstrumentation() 的 startActivitySync(Intent) 进 行 应 有 





2) 编辑 界面 : 输入 文本 框 1 和 文本 框 2( 即 textview1 和 textview2) 的 文字 并 设置 两 个 文本 框 的 属性 。 要 实现 输入 和 选择 ， 首 先 得 找到 需要 输入 和 选择 的 控件 。 











通过 HierarchyViewer 对 控件 ID 进行 捕获 后 ， 就 能 以 这 种 方式 获取 控件 了 ， 如 代码 清单 4-40 所 示 。 


代码 清单 4-40 ”获取 控件 


// xuben: 通过 changeAutoTest 的 findViewById 获 取 ChangeActivity 界 面 控件 
txtl = (EditText)changeAutoTest.findViewById(R.id.txt1); 

txt2 = (EditText)changeAutoTest.findViewById(R.id.txt2); 

bold = (RadioButton)changeAutoTest.findViewById (R.id.bold); 
notbold = (RadioButton)changeAutoTest.findViewById (R.id.notbold); 


small = (RadioButton) changeAutoTest.findViewById (R.id.small); 
big = (RadioButton)changeAutoTest.findViewById (R.id.big); 
subButton = (Button) changeAutoTest.findViewById (R.id.myButton01); 





这 里 的 changeAutoTest 就 是 上 一 步 中 启动 ChangeActivity 界 面 时 返回 的 对 象 。 





获取 到 控件 后 ， 就 可 以 对 其 进行 编辑 ， 如 代码 清单 4-41 所 示 。 


代码 清单 4-41 编辑 控件 





// xuben: 要 操作 待 测 程序 的 UI 必 须 在 runTestOnUiThread () 中 执行 
runTestOnUiThread (new Runnable() ( 
GOverride 
public void run() 
{ 
// xuben: 编辑 界面 中 的 文本 框 中 文字 
txt1.setText (bugben_txt1); 
txt2.setText (bugben_txt2); 
// xüben: 选择 文本 框 1 为 加 粗 ， 文 本 框 2 为 大 号 字体 
bold.setChecked (true) ; 
big.setChecked (true); 
// xuben: 等 待 500ms 以 避免 程序 响应 慢 出错 
SystemClock.sleep (500); 
// xuben: 点 击 sSubButton 按 钮 ， 提 交 输 入 文本 
subButton.performClick(); 
l 
n; 











这 段 代码 对 文本 框 的 文字 和 属性 进行 了 设置 ， 需 要 注意 的 是 ， 这 段 代 码 是 在 runTestOnUiThread(new Runnable() 中 的 run() 方 法 中 执行 的 ， 这 个 后 续 将 详细 分 析 ， 这 里 大 家 











的 UI 必须 在 runTestOnUiThread 这 个 线程 中 运行 。 


3) 结果 提交 : 点 击 提交 按钮 ， 即 subButton， 将 触发 按钮 事件 进行 数据 传递 。 





subButton 的 点 击 已 经 在 上 一 步 中 进行 ， 即 SubButton.performClick()， 因 为 点 击 按钮 也 属于 操作 界面 控件 ， 所 以 也 需要 在 runTestOnUiThread 这 个 线程 中 执行 。 














下 面 我 们 重点 来 看 看 界面 跳 转 需要 关注 的 内 容 ， 这 也 是 Instrumentation 自 动 化 测试 中 界面 跳 转 最 需 注 意 的 一 个 点 。 














4) 界面 跳 转 : 点 击 后 界面 将 从 编辑 界面 ChangeActivity 跳 转 至 结果 显示 界面 HelloBugbenActivity。 














如 何 响应 按钮 事件 并 进行 界面 跳 转 是 待 测 项 目 需要 做 的 事 ， 而 如 何 确认 界面 已 经 跳 转 则 是 测试 项 目 需要 关注 的 焦点 。 





在 Instrumentation 中 ， 是 通过 对 跳 转 后 的 界面 设置 Monitor (监视 器 ) 来 确认 的 ， 如 代码 清单 4-42 所 示 。 








代码 清单 4-42 设置 Monitor 


只 需 记 住 ， 操 作 待 测试 程序 





// xuben: 添加 一 个 监视 器 ， 监 视 HelloBugbenActivity 的 启动 
ActivityMonitor bugbenMonitor = 


getInstrumentation () .addMonitor (HelloBugbenActivity.class.getName(), null, false); 


Os 必须 在 界面 操作 前 对 Monitor 设 置 ， 即 上 述 代码 应 该 放置 在 runTestOnUiThread 线 程 前 


通过 addMonitor() 方 法 对 跳 转 后 的 界面 HelloBugbenActivity 进 行 监视 设置 后 ， 就 可 以 通过 runTestOnUiThread 进 行 界面 操作 ， 操 作 后 ， 





代码 清单 4-43 ”界面 跳 转 确 认 


// xuben: 从 ActivityMonitor 监 视 器 中 获取 HelloBugbenActivity 的 实例 

helloBugbenAutoTest = (HelloBugbenActivity) getInstrumentation () 
.waitForMonitor (bugbenMonitor) ; 

// xuben: HelloBugbenActivity#) £#|helloBugbenAutoTest È FAS 

assertTrue (helloBugbenAutoTest != null); 











通过 waitForMonitor() 方 法 等 待 界面 跳 转 ， 并 返回 跳 转 后 的 界面 对 象 。 


























通过 assertTrue() 方 法 检验 返回 的 界面 对 象 不 为 空 ， 即 跳 转 正常 。 














面 。 








5) 验证 显示 : 界面 跳 转 后 ，HelloBugbenActivity 将 正确 显示 编辑 界面 所 录入 的 文字 和 选择 的 


代码 清单 4-44 ”验证 显示 





属性 ， 这 也 是 此 项 自动 化 测试 的 验证 点 ， 如 代码 清和 





4-44 所 示 。 


我 们 将 通过 如 下 代码 进行 界面 跳 转 确认 ， 如 代码 清单 4-43 所 





// xuben: i&ithelloBugbenAutoTest 4) findViewByld# RX AE 

textviewl =(TextView) hel loBugbenAutoTest . findViewBylId (R.id.myTextView01) ; 
textview2 =(TextView) helloBugbenAutoTest .findViewByld (R.id.myTextView02) ; 
// xuben: 验证 文本 框 1 的 文本 ， 该 文本 应 为 " 巴 哥 奔 " 

assertEquals (bugben txtl, textviewl.getText ().toString()); 

// xuben: 验证 本 框 2 的 文本 ， 该 文本 应 为 "小 简洁 " 

assertEquals (bugben txt2，textview2.getText ().toString()); 

// xuben: 验证 文本 框 1 的 文本 属性 ， 应 为 加 粗 

TextPaint tp = textviewl.getPaint(); 

Boolean cmpBold = tp.isFakeBoldText (); 

assertTrue (cmpBold); 

// xuben: 验证 本 框 2 的 文本 字号 ， 应 为 大 号 

Float cmpSize = textview2.getTextSize(); 

assertTrue (cmpSize.compareTo (bugben big size) == 0); 

















界面 正常 跳 转 后 ， 需 要 先 通过 跳 转 后 的 界面 对 象 helloBugbenAutoTest 的 findViewByld() 方 法 去 获取 界面 控件 textview1 和 textview2， 获 取 后 即 可 通过 getText() 等 方法 对 结果 进行 验证 。 





完整 的 自动 化 测试 项 目 ， 如 代码 清单 4-45 所 示 。 


代码 清单 4-45 ”完整 的 自动 化 测试 项 目 





package com.xuben.hellobugben.test; 

import com.xuben.hellobugben.ChangeActivity; 

import com.xuben.hellobugben.HelloBugbenActivity; 
import com.xuben.hellobugben.R; 

import android.app.Instrumentation.ActivityMonitor; 
import android.content.Intent; 

import android.os.SystemClock; 

import android.test.ActivityInstrumentationTestCase2; 


import android.text.TextPaint; 
import android.util.Log; 
import android.widget.Button; 
import android.widget.EditText; 
import android.widget.RadioButton; 
import android.widget.TextView; 
public class HelloBugbenTestBase extends ActivityInstrumentationTestCase2<ChangeActivity> { 
public HelloBugbenTestBase() ( 
super (ChangeActivity.class); 
// TODO Auto-generated constructor stub 
} 
ChangeActivity changeAutoTest; 
HelloBugbenActivity helloBugbenAutoTest; 
private EditText txtl; 
private EditText txt2; 
private RadioButton bold; 
private RadioButton notbold; 
private RadioButton small; 
private RadioButton big; 
private Button subButton; 
private TextView textviewl; 
private TextView textview2; 
// xuben: 输入 值 
String bugben txtl = "E 3 £p"; 
String bugben txt2 小 简洁 "; 
Boolean bugben bold = true; 
Boolean bugben notbold = false; 
Float bugben small size = (float) 20.0; 
Float bugben big size = (float) 60.0; 
GOverride 
public void setUp() throws Exception( 
super.setUp(); 
// xuben: 启动 ChangeActivity 
Intent intent = new Intent(); 
intent.setClassName ("com.xuben.hellobugben", ChangeActivity.class.getName()); 
intent.setFlags (Intent.FLAG ACTIVITY NEW TASK); 
changeAutoTest - (ChangeActivity)getInstrumentation ().startActivitySync (intent); 
// xuben: ii itchangeAutoTest #4) findViewByIdj&JKkChangeActivityJftd 
txtl = (EditText)changeAutoTest.findViewById (R.id.txt1l); 
txt2 (EditText)changeAutoTest.findViewById (R.id.txt2); 
bold (RadioButton) changeAutoTest.findViewById (R.id.bold); 
notbold = (RadioButton)changeAutoTest.findViewById (R.id.notbold); 
small = (RadioButton)changeAutoTest.findViewById (R.id.small); 
big = (RadioButton)changeAutoTest.findViewById (R.id.big); 
subButton = (Button) changeAutoTest.findViewById (R.id.myButton01); 








} 

@Override 

public void tearDown() throws Exception{ 
super. tearDown () ; 


} 
// xuben: 基本 提交 测试 
public void testSubmit() throws Throwable ( 
// xuben: 通过 1og 表 示 运 行 的 是 哪 一 个 自动 化 用 例 
Log.v("testSubmit", "test normal submit."); 
// xuben: 添加 一 个 监视 器 ， 监 视 HelloBugbenActivity 的 启动 
ActivityMonitor bugbenMonitor = getInstrumentation () 
.addMonitor (HelloBugbenActivity.class.getName(), null, false); 
// xuben: 要 操作 待 测 程序 的 UI 必 须 在 runTestOnUiThread () 中 执行 
runTestOnUiThread (new Runnable() ( 
GOverride 
public void run() 


{ 
// xuben: 编辑 界面 中 的 文本 框 中 文字 
txt1.setText (bugben_txt1); 
txt2.setText (bugben_txt2); 
// xuben: 选择 文本 框 1 为 加 粗 ， 文 本 框 2 为 大 号 字体 
bold.setChecked (true); 
big.setChecked (true); 
// xuben: 等 待 500ms 以 避免 程序 响应 慢 出 错 
SystemClock.sleep (500); 
// xuben: 点 击 sSubButton 按 钮 ， 提 交 输 入 文本 
subButton.performClick(); 
} 
1); 
// xuben: 从 ActivityMonitor 监 视 器 中 获取 HelloBugbenActivity 的 实例 
helloBugbenAutoTest = (HelloBugbenActivity) getInstrumentation () 
.waitForMonitor (bugbenMonitor) ; 
// xuben: HelloBugbenActivity#) X4 |helloBugbenAutoTestJ FA Z 
assertTrue (helloBugbenAutoTest != null); 
// xuben: ii ithelloBugbenAutoTest 44 findViewByIdjk RX AGE 
textviewl -(TextView)helloBugbenAutoTest.findViewById (R.id.myTextView01) ; 
textview2 - (TextView)helloBugbenAutoTest.findViewById (R.id.myTextView02); 
// xuben: 验证 文本 框 1 的 文本 ， 该 文本 应 为 " 巴 哥 奔 " 
assertEquals (bugben txtl, textviewl.getText ().toString()); 
// xuben: 验证 本 框 2 的 文本 ， 该 文本 应 为 "小 简洁 " 
assertEquals (bugben txt2, textview2.getText ().toString()); 
// xuben: 验证 文本 框 1 的 文本 属性 ， 应 为 加 粗 
TextPaint tp = textviewl.getPaint (); 
Boolean cmpBold = tp.isFakeBoldText (); 
assertTrue (cmpBold) ; 
// xuben: 验证 本 框 2 的 文本 字号 ， 应 为 大 号 
Float cmpSize = textview2.getTextSize(); 
assertTrue (cmpSize.compareTo (bugben big size) — 0); 





| 
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[i] 
aq 
it 


果 如 图 4-32 所 示 。 





i$ Package Explorer (gjë JUnit 33 o 8 


9 9 oe BB|G R, m E - Y 


Finished after 0.898 seconds 


Runs: 1/1 «Errors: OG Failures: DO 


日 Ei ] lenovo-lenovo. | k910-aaf67ffc [Runner: JUnit 3] (1.025 s) 


B. ti 日 com. xuben. hellobugben. test. HelloBugbenTestBase (1.025 s) 
cel t 








A432 ”运行 结果 
备注 : 


事实 上 ， 真 实 场景 测试 至 少 要 分 别 写 4 个 独立 的 自动 化 用 例 (分 别 测试 文本 框 1 的 文字 、 文 本 框 2 文字 、 文 本 框 1 属性 和 文本 框 2 字号 ) ， 但 这 4 个 用 例 绝 大 部 分 代码 雷同 ， 所 以 此 处 为 了 节省 大 家 时 间 ， 就 
写 到 一 起 了 一 一 这 样 的 兽 端 在 于 ， 如 果 其 中 一 个 用 例 的 验证 (assert) 挂 掉 (fal) 了 ， 结 果 显示 整个 测试 用 例 fail。 


eo... 巴 哥 奔 建 议 大 家 在 真实 场景 中 分 开 写 一 一 自动 化 用 例 相 互 独立 且 职 责 单一 是 良好 自动 化 用 例 最 基本 的 要 求 ， 记 住 巴 哥 奔 的 话 吧 ， 呼 呼 ! 


4.10 Instrumentation 工 具 总 结 


从 上 节 的 例子 不 难看 出 ，Instrumentation 框 架 运行 流程 ， 如 图 4-33 所 示 。 





1. 启 动 应 用 Activity : Intent 


2. 获取 Activity 的 实例 : Instrumentation. 
ActivityMonitor 





— 3， 获取 Activity 中 UI 的 实例 : findViewByldQ | 





“一 一 4. 执行 UI 操作 : runTestOnUiThread() | 
一 。5， 获 取 UI 属 性 : UI 实例 
| — 4 6. 验证: Assert() | 








图 4-33 ”Instrumentation 框 架 运行 流程 








更 直观 的 表述 如 图 4-34 所 示 。 





command InstrumentationTestRunner 





94-34 Instrumentationi£ 47 


6, conan, 由 于 Instrumentation 框 架 基 于 项 目 源码 进行 开发 ， 所 以 具有 其 他 框架 很 难 拥有 的 得 天 独 厚 的 优势 。 
| NAME 


QO onawannenn (控件 ID 改 动 较 少 ) o 
可 移植 性 好 (控件 移动 位 置 对 其 影响 较 小 ) 。 
运行 效率 高 (直接 调用 控件 进行 操作 ) o 


调试 方便 (与 项 目 源码 一 起 调试 ) 。 





Instrumentation 优 势 如 图 4-35 所 示 。 


通过 控件 ID 


Layout 4712 ms 
Draw: 1965 ms 





图 4-35  Instrumentation4, # 


65, ans 大 ， 我 发 现 使 用 这 个 东西 后 咱们 测试 效率 有 了 很 大 幅度 的 提升 ! 





ER, MÁA! 


Yt €) eat, 我 也 听 到 一 些 反 馈 ， 说 脚本 非常 难 写 ， 而且 存在 一 些 局 限 性 ， 所 以 咱们 还 是 多 说 说 它 的 不 足 吧 1 


29... 首当其冲 的 就 是 您 刚才 提 到 的 问题 ， 难 以 上 手 。 

由 于 Instrumentation 是 基于 源码 进行 脚本 开发 ， 所 以 需要 脚本 开发 人 员 对 Java 语 言 、Android 框 架 运 行 机 制 、Eclipse 开 发 工具 都 非常 熟悉 。 
还 需要 大 家 能 读 懂 项 目的 源码 ， 才 能 有 效 地 进行 脚本 开发 。 

89, ur 

你 知 不 知道 咱们 雇 一 个 测试 员 多 少 钱 ? 雇 一 个 程序 员 又 是 多 少 钱 ? 

这 个 框架 要 求 这 么 高 ， 相 当 于 我 需要 雇佣 两 倍 的 程序 员 来 工作 ， 这 简直 要 我 亲 命 了 ! 

QO caren, 不 过 的 确 门 槛 会 高 一 些 。 


Vd Cups gt dae 如 果 大 家 从 零 开始 学 编程 ， 你 觉得 多 长 时 间 能 达到 要 求 ? 


$9. onis, 每 个 人 的 资质 不 同 ， 对 编程 的 兴趣 也 不 同 。 


如 果 从 零 学 起 ， 开 发 效率 的 确 会 受到 很 大 的 影响 ， 而 且 脚 本 质量 也 不 高 ， 对 于 后 期 脚本 维护 代价 较 大 。 


| CNN 自身 最 大 的 问题 是 不 支持 多 应 用 交互 。 
比如 ， 我 们 测试 “通过 短信 中 的 号 码 去 拨打 电话 ”这 个 用 例 ， 此 时 被 测 应 用 将 从 短信 应 用 界面 跳 转 到 拨号 瘟 应 用 界面 ， 但 Instrumentation 没 办 法 同时 控制 短信 和 拨号 两 个 应 用 。 


se ] 
SOM? 这 是 为 什么 呢 ? 






9o,, 因为 Android 系 统 自身 的 安全 性 限制 ， 禁 止 进程 间 相 互 访问 。 
9o. 进程 无 法 直接 启动 另 一 个 进程 的 Activity， 而 是 定义 一 个 Intent 并 交 由 Android 系 统 去 选择 启动 能 够 处 理 该 Intent 的 Activity， 并 由 系统 管理 该 Activity 的 所 有 活动 。 


eo. 进程 无 法 获取 该 Activity 所 在 进程 的 任何 信息 。 


a 


E 听 不 懂 …… 


9o... 这 种 做 法 不 会 影响 系统 正常 的 运行 ， 但 从 测试 的 角度 而 言 的 确 是 个 琼 手 的 问题 。 


OSs <n, 大 地 呐 ， 你 还 要 不 要 我 活 了 ? 给 你 两 个 选择 ， 要 么 你 加 班 熬 夜 给 我 拼命 产 出 脚本 ， 要 么 你 再 找 个 让 我 满意 的 东 东 来 ! 


eo... BLIRGEARuk AL, MRRRAB HARA T! 


第 5 章 ”终极 自动 化 框架 UIAutomator 使 用 详解 





ESA, KGRL, HRA, EHH? 


5.1 UlIAutomator 概 述 


So 
SARE, MAA RAI RBA A, m — Rb MMA THY? 


9o... 就 算 对 我 没 信心 ， 也 不 应 该 对 Android 官 网 主推 的 自动 化 框架 没 信心 啊 ! 一 起 来 看 看 吧 ! 


ee 先 说 说 都 有 哪些 优点 吧 ! 
9o,,. 它 注入 原生 事件 进行 模拟 。 
其 次 ， 它 具有 很 好 的 耦合 性 。 

第 三 ， 它 支持 跨 应 用 操作 。 

第 四 ， 它 可 方便 地 进行 事件 监控 。 

第 五 ， 它 扩展 性 也 非常 好 。 

第 六 ， 它 可 借助 IJnstrumentation 框 架 运行 。 


最 后 ， 它 非常 容易 上 手 。 
s» 
人 5 哇 ， 当 真 口 若 悬 河 ， 让 我 想起 星 耸 在 “ 九 品 芝麻 官 ”中 吵架 的 场景 


06... 听 得 我 也 眼 冒 金星 ， 你 还 是 逐一 跟 大 家 说 明 一 下 吧 ! 


QOO, aui 





本 来 位 置 ) 。 


作为 一 把 无 双 的 倚天 剑 ，UIAutomator 的 特点 非常 显著 。 












































前 面 介绍 Instrumentation 时 提 到 ， 当 UIAutomator 这 把 倚天 剑 被 Android 祭 出 后 ，Instrumentation 就 基本 与 自动 化 Say Goodbye 了 (当然 ， 此 时 Instrumentation 也 才 真 正 回归 到 其 单元 测试 框架 的 


首先 ，UIAutomator 通 过 注入 原生 事件 进行 模拟 一 一 通过 模拟 用 户 操作 来 与 设备 用 户 界面 交互 以 及 获取 屏幕 内 容 ， 它 依赖 于 平台 的 辅助 功能 API 在 远程 的 控件 树 上 获取 屏幕 内 容 以 及 执行 一 些 操作 。 同 
































时 ， 它 也 人 允许 通过 注入 原生 事件 〈 即 InputEvent) 来 模拟 用 户 的 按键 和 触 屏 操作 。 通 过 调 上 




















对 象 来 执行 事件 注入 操作 。 





























其 次 ，UIAutomation 具 有 很 好 的 耦合 性 一 一 它 既 不 会 像 Instrumentation 一 样 为 控制 

































































第 三 ，UIAutomation 支 持 跨 应 用 操作 一 一 用 户 可 编写 可 以 跨越 多 个 应 用 的 测试 用 例 肝 
也 正好 是 Instrumentation 的 缺陷 所 在 。 

















第 四 ，UIAutomation 还 可 方便 地 进行 事件 监控 























每 次 有 事件 触发 的 时 候 接收 到 一 个 发 送 给 onAccessibilityEvent() 方 法 的 回调 ， 而 参数 就 是 一 个 描述 该 村 


第 五 ，UIAutomation 的 扩展 性 也 是 非常 好 的 一 一 它 提供 了 一 系列 接口 供 大 家 进行 二 次 














其 executeAndWaitForEvent() 函 数 对 应 






































注入 不 同 的 事件 来 进行 测试 ， 该 函数 将 接受 一 个 可 执行 Runnable 线 程 


民 务 的 生命 周期 而 提供 钩子 (hooks) ， 也 不 会 调用 那些 可 直接 用 于 用 户 界面 测试 自动 化 的 APl。 例 如 ， 模 拟 一 个 








户 在 屏幕 上 的 点 击 事件 需要 构造 并 注入 一 个 按 下 和 一 个 弹 起 事件 ， 然 后 必须 调用 UIAutomation 的 一 个 injectInputEvent(InputEvent,boolean) 方 法 的 调用 来 发 送 给 操作 系统 。 














本 了 。 例 如 ， 打 开 系 统 的 设置 应 用 去 修改 一 些 设置 ， 然 后 再 与 男 外 一 个 依赖 于 该 设置 的 应 用 进行 交互 。 而 这 点 ， 

















发 或 一 些小 工 





只 需 创建 一 个 UIAutomation.OnAccessibilityEventListener 的 实现 类 并 将 它 的 实例 传递 给 setOnAccessibilityEventListener() 方 法 。 监 听 接 











将 会 在 





到 件 的 AccessibilityEvent 的 对 象 。 

















的 开发 。 








第 六 ，UIAutomation 还 可 借助 Instrumentation 框 架 运 行 一 一 通过 调用 Instrumentation.getUiAutomation() 方 法 即 可 获得 UiAutomation 的 一 个 实例 。 在 adb shell 上 运行 Instrumenta-tionTestCase 


时 只 需 在 instrument 命 令 后 加 上 “-w” 选 项 即 可 运行 。 























最 后 ，UIAutomation 非 常 容易 上 手 一 一 不 仅 具 有 非常 清晰 的 控件 捕获 ， 脚 本 编写 的 门槛 也 大 大 降低 ， 开 发 效率 非常 高 。 








从 Android 官 网 UI 测试 (UI Testing) 对 UIAutomator 的 推崇 就 可 以 看 出 ， 未 来 Android 自 动 化 必 将 基于 UIAutomator 进 行 ， 下 面 简单 介绍 一 下 这 款 神器 。 


UI Testing 网 址 : http://developer.android.com/tools/testing/testing_ui.html, 








5.2 第 七 个 Impossible Mission 


89... ! ! 研发 部 门 昨 晚 发 出 紧急 通知 : 出 于 安全 性 考虑 ， 将 不 再 给 咱们 提供 源码 。 没 有 源码 ，Instrumentation 脚 本 就 没 法 维护 了 ， 这 将 导致 全 线 竣 疾 …… 
全 改 额 ， 程 序 员 们 这 是 找 抽 的 节奏 吗 ? 


2o... WA AAbug, MÆRKER? ! 那 就 让 他 们 尝 尝 倚天 剑 的 滋味 吧 ! 


5.3 ”更 清晰 的 控件 捕获 


eo 先 把 bugben 应 用 安装 到 手机 上 。 


第 一 步 ， 先 将 待 测 应 用 Bugben 安 装 到 手机 上 ， 安 装 完成 后 如 图 5-1 所 示 。 





ORS- O Fwi OD 1826 
bugben 


请 在 下 框 中 输入 希望 修改 的 文字 


HAN JA 


Jugben A: BBA 


ugbenQQ: 1971629467 





图 5-1 Bugben 应 用 界面 
eo... 接 下 来 就 是 控件 捕获 了 ， 还 记得 Instrumentation 是 怎么 做 的 吗 ? 
全 当然 记得 ， 是 通过 无 敌 的 控件 捕获 工具 HierarchyViewer! 


| MORE 的 无 敌 吗 ? 注意 看 右 下 角 。 





通过 HierarchyViewer 捕 获 的 控件 信息 ， 如 图 5-2 所 示 。 











wr, 

EditText 

@414d1700 
id/oxt1 


Son? | 居然 捕获 的 文字 是 乱码 ， 给 跷 了 ! 当时 我 咋 没 注意 ? 














| — NEAR ERRE, MEA, ARM 





通过 UIAutomatorViewer 捕 获 的 控件 信息 ， 如 图 5-3 所 示 。 


图 5-2 ”HierarchyViewer 捕 获 控件 中 的 “小 简洁 ” 





字符 串 时 显示 为 乱码 


L UI Automator Viewer - [Cl xÍ 





Ye LC ESI [a 17:19 
bugben 


请 在 下 框 中 输入 希望 修改 的 文字 : 
LAELLE: MN 














S- (0) FrameLayout [0,0][1080, 1920] 
B- (0) LinearLayout [0,0][1080, 1920] 
(0) FrameLayout [0,75)(1080,150] 
E (1) FrameLayout [0,150)[1080,1920] 
=}. (0) TableLayout [0,150][1080, 192 
(0) TextView: 请 在 下 框 中 输入 
日 -(1) TableRow [0,231][1080,37 





(0) TextView: Xr Z1 3733 
E (1) EditText: 小 简洁 [327, 
DOE) POE E1- (2) TableRow [0,375][1080,51 
框 2 ， (0) Textyview: 文 本 框 2 文字 
uu =) ANS ORS | (1) EditText:BugbenQQ:15 x 
4 f o "^m ul 
提交 


1 
小 简洁 
com.xuben.hellobugben:id/txt1 
android.widget.EditText 
com.xuben.hellobugben 
content-desc 
checkable false 
checked false 


clickable true 
enabled true 
focusable true 


focused true 
scrollable false 
long-clickable true 
password false 
selected false 
bounds [327,231)[966,375] 








5-3 UlAutomatorViewer4£ fF dili 3k Jr- dg 


fe 
a, 


全 这 是 哈 东 东 ， 看 不 清楚 控件 文字 ， 能 局 部 放大 吗 ? 





通过 UIAutomatorViewer 捕 获 界面 控件 树 ， 如 图 5-4 所 示 。 














H A 


日 
È- (0) FrameLayout [0,0][1080,1920] 
È- (0) LinearLayout [0,0][1080,1920] 
-(0) FrameLayout [0,75][1080,150] 
=). (1) FrameLayout [0,150)(1080, 1920] 
E o TableLayout [0,150][1080, 1920] 
一 (0) Textyiew: 请 在 下 框 中 输入 希望 修改 的 文字 : [0,150][1080,231] 
ga ) TableRow [0,231)(1080,375] 


| »" ee SEAT ; S E Pi 再 也 没有 ÉL 
IB 1) EditTe> ‘fal ve [327,231)[966,375 
TAA T 


S TatleRow (o 375][1080,519] 
i (0) TextView: NEEF : [0,410)[327,475] 

|— —(1)EditText:BugbenQQ:1971629467 [327,375)[966,519] 
|. 3) Textyiew: 请 选择 文字 属性 : [0,519][1080,600) 

由 - (4) TableRow [0,600][1080,744] 

由 -(5) TableRow [0,744][1080,888] 

(6) Button; 提 交 [0,888][1080,1032] 






图 5-4 UIAutomatorViewert 控 件 捕 获 界面 右上 角 控 件 树 


prs) 


必 哇 ， 中 文 显示 得 好 清晰 ! 再 让 我 看 看 工具 右 下 角 是 哈 ! 





当然 ， 右 下 角 的 丰富 信息 也 绝对 让 你 满意 ， 如 图 5-5 所 示 。 


Node Detail 

index 1 

text 小 简洁 

resource-id com.xuben.hellobugben:id/txt 1 
class android. widget .Edit Text 
package com. xuben.hellobugben 
content-desc 

checkable false 

checked false 

clickable true 

enabled true 

focusable true 

focused true 

scrollable false 

long-clickable true 

password false 

selected false 

bounds [327,231)[966,375] 





5-5 ”UIAutomatorViewer 控 件 捕获 界面 右 下 角 控 件 详情 
e» 
Sok, Ay AAM b UO open 6 AIME 5, EER! 


96, , rasis 自动 化 测试 的 那些 工具 〈 诸 如 QTP，Xacc 之 类 的 控件 捕获 工具 ) ， 刚 转型 做 Android 自 动 化 的 同学 们 ， 是 不 是 有 种 他 乡 遇 故 知 ， 眼 泪 要 掉 下 来 的 感觉 ? 


E 
Sop, BA AREF, AERA” RSET! 


54 ”更 直观 的 测试 项 目 创建 


go, 下 面 我 们 开始 创建 测试 项 目 。 在 创建 之 前 ， 咱 们 先 按照 官网 推荐 的 步骤 检查 一 下 。 


g 


» 


好 的 ! 















要 创建 UIAutomator 测 试 项 目 ， 按 照 官 网 推荐 的 步骤 如 下 。 























第 1 步 。 将 待 测 应 用 安装 到 设备 中 。 





5 
SY CAGE! 











第 2 步 。 识 别 应 用 UI 组 件 (Ul components) : UI 组 件 应 包含 文本 标签 (text labels) 或 描述 标签 (tandroid:contentDescription) ， 或 两 者 兼 有 。 











e» 
CHO i 38 AL de 5] BAL ABE JG den GK? 


Okra, 不 过 这 里 是 出 于 自动 化 脚本 稳定 性 考虑 的 ， 后 面 大 家 将 会 发 现 的 确 如 此 。 








第 3 步 。 确 保 该 应 用 可 访问 。 














mE 





对 于 ImageButton、ImageView 和 CheckBox 等 控件 需要 包含 控件 描述 属性 ， 即 android:contentDescription ( 巴 哥 奔 : 这 对 于 UIAutomator 自 动 化 脚本 的 稳定 性 和 移植 性 非常 重要 ) 。 




















2) 对 于 EditText 等 控件 需要 包含 提示 文本 属性 ， 即 android:hint ( 巴 哥 奔 : 编辑 框 的 提示 文本 对 于 抓 取 该 控件 至 关 重 要 ) 。 











Ww 





对 于 控件 的 图 标 最 好 关联 android:hint ( 巴 哥 奔 : 原理 同上 ) 。 




















4) 确保 用 户 界面 上 所 有 元 素 的 定向 控制 器 (directional controller) ， 如 轨迹 球 、D-pad 等 ， 均 可 正常 使 用 。 























5) 通过 UIAutomatorviewer 工 具 确 保 UI 组 件 支持 测试 框架 (BH: 这 里 指 UIAuto-mator 测 试 框架 ) 。 








s» 
SS 确认 一 个 应 用 是 否 可 用 居然 这 么 麻烦 ? 有 些 画蛇添足 吧 1 





这 里 主要 指 应 用 对 UIAutomator 工 具 的 支持 度 ， 此 处 官网 提 到 的 几 点 都 是 实际 项 目 中 非常 关键 的 点 。 

















第 4 步 。 配 置 测试 环境 : 即 引 入 UIAutomator 测 试 包 ， 具 体 步骤 如 下 。 




















1) 创建 测试 项 目 ， 这 里 继续 沿用 HelloBugbenTest 这 个 测试 项 目 。 
2) 右键 点 击 测试 项 目 HelloBugbenTest 选 择 “Properties>Java Build Path" , 
x “Add Library>JUnit then select JUnit3” 添 加 JUnit 框 架 ; 


- 点击“Add External JARshttp:/ /www.hzcourse.com/ resource /readBook?path- /openresources/teach. ebook /uncompressed/15501 /OEBPS/Text/...” 并 导航 到 Android SDK A 3€, 选择 platforms 目 录 下 面 的 
android.jar 和 UIAutomator.jar 两 个 文件 ， 如 图 5-6 所 示 。 


Properties for HelloBugbenTest 

















图 5-6 3 android.jar fe ULAutomator.jar 
LM 这 就 完了 ? 


Oun, 测试 项 目 就 这 样 创 建 完了 ， 稍 事 休息 一 下 ， 然 后 开启 咱们 的 脚本 之 旅 吧 ! 


5.5 UlAutomator API 详 解 


QO asmin, 咱们 还 是 先 来 学 习 一 下 UIAutomator 常 用 的 API 吧 ! 

E en 想起 个 问题 : 为 什么 Instrumentation 框 架 不 需要 专门 学 习 API， 而 其 他 框架 需要 学 习 相 关 测 试 框架 的 API 呢 ? 

Opna 这 可 以 算是 Instrumentation 基 于 源码 的 一 个 好 处 。 因 为 它 调用 测试 控件 的 方式 和 源码 调用 的 方式 保持 一 致 ， 所 以 不 需要 单独 的 API。 

B ak, 所 有 基于 源码 的 框架 都 不 需要 单独 编写 API? 

Qe 当然 不 是 ， 很 多 基于 Instrumentation 进 行 二 次 封装 的 框架 ， 比 如 Robotium 等 都 会 提供 非常 翔实 的 API。 因 为 封装 的 主要 用 途 就 是 提高 易 用 性 和 代码 的 可 读 性 。 


Ea. 明白 了 ! 那 咱 们 一 起 来 看 看 UIAutomator 的 API 和 monkey 父 子 的 有 哪些 不 同 吧 ! 
在 “com.android.UIAutomator.core” 类 下 方 ， 横 吾 着 UIAutomator 最 基本 的 几 个 API。 下 面 ， 我 们 从 实际 需求 出 发 ， 对 最 基本 和 最 关键 的 API 进 行 简要 介绍 。 


API 官 网 地 址 : http;//developer.android.com/tools/help/UlAutomator/index.html, 
B es. 我 发 现 官网 里 面 分 得 很 细 ， 比 如 UiDevice，Uiobject 等 ， 看 得 我 头 都 大 了 ! 
2 呵呵 ， 对 于 初学 者 这 的 确 有 些 困 难 ， 这 样 吧 ， 我 先 将 常用 API 拆 散 了 ， 与 monkey-runner 对 照 着 分 析 ， 然 后 再 综述 一 下 ， 如 何 ? 


L -— 正 合 我 意 ! 


5.5.1 与 monkeyrunner 对 照 之 : 给 力 的 手势 











首先 来 看 手势 ，monkeyrunner 中 的 手势 主要 指 通过 MonkeyDevice 的 drag() 方 法 直接 传 入 A 点 和 B 点 的 坐标 进行 拖 扫 操作。monkeyrunner 对 应 API 如 下 。 




















boolean drag (int startX, int startY, int endX, int endY, int steps) 


UIAutomator 中 与 之 相对 的 AP| 为 UiObject 的 dragTo() 方 法 ， 如 下 。 


boolean dragTo(int destX, int destY, int steps) 























该 方法 拖 搜 对 象 到 屏幕 某 个 坐标 位 置 上 ， 步 长 可 设置 拖 动 速度 。 除 此 之 外 ，UiObject 还 有 个 简便 的 dragTo() 方 法 ， 如 下 。 

















boolean dragTo(UiObject destObj, int steps) 














该 方法 拖 搜 对 象 到 另 一 个 对 象 位 置 上 (而 不 是 对 应 坐标 ) ， 这 个 方法 最 大 的 优势 是 引入 了 UI 对 象 (UiObject) 概念 ， 使 得 拖 搜 更 精准 。 





另外 ，monkeyrunner 可 借助 于 拖 搜 手势 通过 输入 屏幕 空白 处 坐标 作为 起 始 位 置 (手指 按 下 的 位 置 ) ， 并 以 另 一 屏幕 空白 处 作为 终点 位 置 (手指 弹 起 的 位 置 ) 来 实现 滑 屏 功能 。 

















LC] 
-人 改 那 UIAutomator 是 否 也 通过 该 方法 进行 滑 屏 呢 ? 


8e 不 是 ，UIAutomator 中 对 应 的 方法 不 再 通过 拖 搜 (dragTo) ， 而 是 通过 UiDevice 中 的 滑动 (swipe) 。 


通过 UiDevice 中 的 滑动 (swipe0) 方法 如 下 。 





boolean swipe (int startX, int startY, int endX, int endY, int steps) 











该 方法 通过 坐标 滑动 屏幕 。 更 简单 的 方法 如 下 。 

















boolean swipe(Point[] segments, int segmentSteps) 





























不 过 UIAutomator 似 乎 还 提供 了 更 好 的 滑 屏 方法 ， 且 不 止 一 个 ， 而 是 系列 方法 ， 这 些 方法 来 自 UiObject， 如 下 。 


(1) boolean swipeUp(int steps) 











该 方法 实现 向 上 滑 屏 ( 拖 动 对 象 往 上 滑动 ) 。 


(2) boolean swipeDown(int steps) 





该 方法 实现 向 下 滑 屏 ( 拖 动 对 象 往 下 滑动 ) 。 








(3) boolean swipeLeft(int steps) 





该 方法 实现 向 左 滑 屏 ( 拖 动 对 象 往 左 滑动 ) 。 








(4) boolean swipeRight(int steps) 























该 方法 实现 向 右 滑 屏 ( 拖 动 对 象 往 右 滑动 ) 。 











UIAutomator 这 一 系列 滑 屏 API 不 仅 使 得 滑 屏 操作 变 得 非常 精确 〈 且 通过 API 名 称 极 大 避免 出 错 ) ， 更 避免 了 通过 拖 搜 去 滑 屏 可 能 造成 的 误 拖 搜 ( 即 不 小 心 点 中 某 个 对 象 ) 操作 。 示 例如 代码 清单 5-1 所 


a 


代码 清单 5-1 向 下 滑 屏 








UiObject bugben down menu = new UiObject (new UiSelector().textStartsWith(" £3 RT 4X ")); 
bugben down menu.swipeDown (10); 








然而 ， 有 一 个 问题 深 深 地 困扰 着 我 们 : 手势 操作 难道 就 只 有 拖 搜 和 滑 屏 吗 ”难道 更 丰富 的 手势 操作 无 法 通过 API 的 方式 提供 给 大 家 ? 




















monkeyrunner 的 确 没有 了 ， 但 UIAutomator 却 没 这 么 弱 。 


首先 ， 通 过 UiObject 提 供 了 多 点 任意 手势 API (performMultiPointerGestureQ) ， 如 下 。 





boolean performMultiPointerGesture (PointerCoordshttp: / /www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/... touches) 


该 方法 实现 “多 点 触 控 手 势 ”， 可 定义 任意 手势 。 


























这 一 手势 已 经 包罗 万 象 ， 不 过 UIAutomator 担 心 用 户 还 得 花 时 间 自 己 定 义 最 常用 的 双 点 触 控 AP1， 于 是 又 提供 了 一 个 双 点 触 控 手 势 API| (performTwoPointerGesture) ， 如 下 。 























boolean performTwoPointerGesture (Point startPointl, Point startPoint2, Point endPointl, Point endPoint2, int steps) 





该 方法 实现 “任意 双 点 触 控 手 势 ” ， 模 拟 双 指 手势 。 





























事实 上 ， 我 们 平时 用 得 最 多 的 手势 是 缩放 手势 ， 即 双 指 向 外 (如 放大 图 片 ) 或 双 指向 内 (如 缩小 图 片 ) ， 所 以 UiObject 索 性 直接 提供 了 这 两 个 方法 ， 如 下 。 





























boolean pinchIn(int percent, int steps) 








该 方法 实现 “ 双 指 向 内 收缩 手势 ”操作 ， 更 准确 地 说 是 “控件 对 角 线 上 的 2 个 点 同时 由 边缘 向 中 心 点 滑动 ”。 其 中 ，percent 代 表 滑 到 对 角 线 百分比 的 位 置 停止 ，steps 代 表 时 间 ， 每 一 步 5ms。 


boolean pinchOut(int percent, int steps) 





该 方法 实现 “ 双 指 向 外 扩张 手势 ”操作 ， 更 准确 地 说 是 “控件 对 角 线 上 的 2 个 点 同时 由 中 心 点 向 边缘 滑动 ”。 
手势 操作 示例 (模拟 多 点 操作 ) ， 如 代码 清单 5-2 所 示 。 


代码 清单 5-2 手势 操作 





UiObject bugben fram = new UiObject (new UiSelector() 
.className ("android.widget.FrameLayout")); 

// xuben: 设计 和 触 点 P1 

PointerCoords pl = new PointerCoords (); 

pl.x = 600; 

pl.y = 600; 

pl.pressure = 1; 

pl.size = 1; 

// xuben: 设计 触 点 P2 

PointerCoords p2 = new PointerCoords(); 

p2.x = 500 

p2.y = 500; 

p2.pressure - 1; 

p2.size = 1; 

// xuben: 将 两 个 触 点 传 入 (此 处 可 传 入 多 个 点 ) 

bugben fram.performMultiPointerGesture (pl, p2); 





5.5.2 与 mnonkeyrunner 对 照 之 : 输入 、 点 击 和 长 按 


说 完 手 势 ， 我 们 能 感受 到 一 些 UIAutomator 的 强大 了 ， 接 下 来 看 输入 。monkeyrunner 通 过 MonkeyDevice 的 type() 方 法 传 入 text 进 行 输入 ， 与 nonkey 一 致 ， 如 下 。 





void type(string message) 





而 UIAutomator 中 对 应 的 是 UiObject 的 文本 设置 (setText()) 方法 。 





boolean setText (String text) 





该 方法 实现 在 对 象 中 输入 文本 。 
输入 文本 内 容 如 代码 清单 5-3 所 示 。 


代码 清单 5-3 ”输入 文本 内 容 





bugben txtl = "小 简洁 " 
UiObject txtl = new UiObject (new UiSelector () .text ("Bugben 微 信 : & 3 4&")); 
if(txtl.exists() && txtl.isEnabled()) 
{ 
txtl.setText (bugben txt1); 
} 





除 此 之 外 ，UiObject 还 精心 地 为 我 们 设置 了 另 一 个 API: 清除 编辑 框 中 的 文本 (clearTextfield()) 方法 ， 如 下 。 





void clearTextField() 





该 方法 实现 清除 编辑 框 中 的 文本 。 


更 历 害 的 是 ， 除 了 能 设置 /清除 编辑 框 中 的 文本 ，UiDevice 还 提供 了 获取 /清除 上 一 次 输入 的 文本 的 AP1， 如 下 。 





String getLastTraversedText () 





该 方法 将 遍历 从 过 去 的 Ul 事件 并 自动 获取 上 一 次 输入 的 文本 。 














void clearLastTraversedText () 





该 方法 将 遍历 从 过 去 的 Ul 事 件 并 自动 清除 上 一 次 的 输入 文本 。 











接 下 来 是 “点 击 ”，monkeyrunner 通 过 MonkeyDevice 的 touch() 方 法 传 入 A 点 坐标 ， 并 通过 DOWN_AND_UP 参 数 直接 完成 点 击 ， 如 下 。 




















void touch(integer x, integer y, integer type) 





而 UIAutomator 中 对 应 的 是 UiObject 的 点 击 (click) 方法 。 





boolean click() 





该 方法 实现 点 击 对 象 操作 。 


当然 ， 更 强大 的 还 在 后 面 ，UiObject 还 提供 了 点 击 并 等 待 新 窗口 方法 ， 如 下 。 





boolean clickAndWaitForNewWindow (long timeout) 








该 方法 实现 点 击 对 象 并 等 待 新 窗口 出 现 (参数 为 等 待 超时 时 长 ) 。 更 简洁 的 方法 如 下 。 





boolean clickAndWaitForNewWindow () 





该 方法 实现 点 击 对 象 并 一 直 等 到 新 窗口 出 现 为 止 ， 方 便 吧 ? 






































Es ut NTC. 

















另外 ， 点 击 对 象 的 哪个 部 位 也 有 讲究 ， 有 的 控件 当 你 点 击 不 同位 置 时 呈现 不 同 反 馈 (如 某 些 应 用 左上 角 的 悬浮 数字 点 击 即 可 消失 ， 但 直接 点 击 应 





Ea 么 ， 如 何 进 行 对 象 的 精确 点 击 ? 
BO Sv oae 方法 是 ， 提 供 点 击 对 象 右 下 角 和 左上 角 的 精确 点 击 API。 
精确 点 击 API 如 下 。 
(1) boolean clickBottomRight() 
该 方法 实现 点 击 对 象 的 右 下 角 。 
(2) boolean clickTopLeft() 
该 方法 实现 点 击 对 象 的 左上 角 。 


点 击 提交 按钮 如 下 所 示 。 








UiObject submit = new UiObject (new UiSelector () .text (" 提 交 ") ) 7 
submit.click(); 





最 后 是 “长 按 ”，monkeyrunner 并 无 对 应 方法 ， 所 以 当时 巴 哥 奔 通过 “从 A 点 拖 搜 到 A 点 并 给 予 一 定 持续 时 间 ” 的 方式 变相 实现 长 按 方法 ， 如 下 。 





device.drag((300, 500), (300, 500), 3, 10) 











该 方法 通过 调用 拖 搜 方法 将 对 象 从 A 点 (X1,y1) 拖 搜 到 A 点 (x1,y1)， 且 拖 搜 持续 时 间 较 长 (如 3 秒 ) ， 达 到 “长 按 (300,500) 这 个 点 3 秒 ” 的 目的 。 














UIAutomator 显 然 不 用 这 么 麻烦 ， 直 接 通过 UiObject 的 长 按 (longClick0) 方法 实现 。 
































boolean longClick() 





该 方法 实现 对 对 象 执行 长 按 操作 。 


当然 ， 也 顺便 提供 了 长 按 对 象 右 下 角 和 左上 角 的 精确 API， 如 下 。 





boolean longClickBottomRight () 





该 方法 实现 长 按 对 象 的 右 下 角 。 





boolean longClickTopleft () 





该 方法 实现 长 按 对 象 的 左上 角 。 


5.5.3 与 monkeyrunner 对 照 之 : 等 待 和 截屏 


看 完 输入 、 点 击 和 长 按 ， 接 下 来 就 是 等 待 ，monkeyrunner 通 过 MonkeyRunner 的 sleep() 方 法 传 入 seconds (单位 : 秒 ) 进行 等 待 操作 ， 如 下 。 





void sleep(float seconds) 





TX UIAutomator X J£ Ju 49 4H $4 95? 


PS iced 非常 细 ， 考 虑 得 也 很 周全 。 


首先 通过 UiObject 提 供 等 待 对 象 出 现 ， 如 下 。 





boolean waitForExists (long timeout) 





该 方法 实现 等 待 对 象 出 现 。 


但 有 时 一 个 操作 不 一 定 会 出 现 某 个 对 象 ， 而 是 某 个 对 象 消失 ， 于 是 又 有 了 等 待 对 象 消失 ， 如 下 。 





boolean waitUntilGone (long timeout) 





该 方法 实现 等 待 对 象 消失 。 


顺便 提 一 下 检查 对 象 是 否 存在 的 AP1， 如 下 。 





boolean exists () 





该 方法 检查 对 象 是 否 存在 。 








除 此 之 外 ，UiDevice 还 提供 了 “等 待 当前 应 用 程序 处 于 空闲 状态 ” ， 以 便 在 适当 的 时 候 对 操作 进行 反馈 ， 如 下 。 




















void waitForIdle(long timeout) 











该 方法 实现 等 待 当前 应 用 程序 处 于 空闲 状态 (参数 为 等 待 超 时 时 长 ) 。 更 简洁 的 方法 如 下 。 




















void waitForIdle() 











该 方法 持续 等 待 当前 的 应 用 程序 处 于 空闲 状态 为 止 。 








但 有 时 往往 并 不 是 窗口 变化 ， 而 是 窗口 内 容 发 生变 化 ， 于 是 又 提供 了 “等 待 窗口 内 容 更 新 事件 的 发 生 ” 方 法 ， 如 下 。 











boolean waitForWindowUpdate (String packageName, long timeout) 














该 方法 将 等 待 窗口 内 容 更 新 事件 的 发 生 。 








等 待 提交 按钮 出 现 如 代码 清单 5-4 所 示 。 


代码 清单 5-4 等待 提 交 按 钮 出 现 





// xuben: 等 待 提交 按钮 出 现 
UiObject subbutton = new UiObject (new UiSelector () .text (" 提 交 ") ) 7 
subbutton.waitForExists (500); 








接 下 来 是 截图 。 对 于 截图 ，monkeyrunner 提 供 了 非常 丰富 的 AP1， 包 括 部 分 截图 、 像 素 转换 等 ， 而 这 明显 不 是 UIAutomator 关 注 的 焦点 。 

















对 于 最 简单 的 截图 ，monkeyrunner 分 两 步 走 。 





首先 ， 通 过 MonkeyDevice 的 takesnapshot() 方 法 获取 当前 屏幕 图 像 ， 如 下 。 











MonkeyImage takeSnapshot () 

















其 次 ， 通 过 Monkeylmage 的 writeTofile() 方 法 将 截取 图 像 另 存 为 图 片 ， 如 下 。 





void writeToFile(string path, string format) 





而 UIAutomator 只 需 通 过 UiDevice 的 一 个 方法 即 可 ， 如 下 。 





boolean takeScreenshot (File storePath) 














该 方法 实现 截屏 并 将 图 像 存储 到 指定 路 径 下 (参数 为 file 类 型 的 文件 路 径 ) 。 确 切 地 说 ， 该 方法 “将 当前 窗口 截图 并 将 其 存储 为 png 默 认 1.0f 的 规模 〈 原 尺寸 ) 和 90% 质 量 ”。 示 例如 代码 清单 5-5 所 示 。 
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代码 清单 5-5 截屏 





// xuben: 手机 端 路 径 

String storePath = "/data/local/tmp/displayCheck.png"; 

// xuben: 截图 对 照 验证 字体 和 字号 

// 注意: 这 里 传 入 的 是 "路 径 + 文 件 ” (File 类 型 ) ， 而 不 单单 是 Path 路 径 

File displayPicFile = new File(storePath); 

Boolean displayCap = UiDevice.getInstance() .takeScreenshot (displayPicFile); 








运行 完成 后 ， 可 通过 批 处 理 将 其 拷贝 至 PC 端 ， 如 下 。 








REM 将 截屏 验证 文件 从 手机 端 拷贝 到 PC 端 
adb pull /data/local/tmp/displayCheck.png "D:\xuben\tools\workspace\HelloBugbenTest" 








当然 ， 如 果 你 非常 关注 图 像 质量 和 缩放 比例 ， 可 通过 如 下 方法 。 














boolean takeScreenshot(File storePath, float scale, int quality) 











该 方法 实现 “将 当前 窗口 截 


[R] 


片 质量 ”。 














片 ， 可 以 自 定 义 缩放 比例 与 





网 








图 为 png 格 式 
参数 详细 说 明 如 下 。 


“storePath: 存储 路 径 ， 必 须 为 png 格 式 。 





*scae: 缩放 比例 ，1.0 为 原 











‘quality: 图 片 压缩 质量 ， 范 围 为 0~100。 


5.5.4 与 nonkeyrunner 对 照 之 : 锁 屏 /唤醒 、 获 取 设 备 属性 


对 于 设备 唤醒 ，monkeyrunner 通 过 MonkeyDevice 的 wake() 方 法 即 可 唤醒 设备 ， 如 下 。 





void wake () 








不 过 monkeyrunner 却 忘记 提供 锁 屏 (但 却 提供 了 重启 ， 呵 呵 ) ， 而 UIAutomator 则 提供 了 锁 屏 、 唤 醒 和 检测 屏幕 是 否 唤醒 的 完整 方法 。 先 来 看 锁 屏 ，UiDevice 的 这 个 方法 很 容易 被 误解 为 等 待 。 








void sleep() 











该 方法 提供 “ 锁 屏 ” (或 者 说 休眠 ) ， 如 果 屏 幕 已 经 是 关闭 的 ， 则 没有 任何 作用 。 








(oa sleep0 在 UIAutomator 中 不 是 等 待 。 


人 我 勒 个 去 ， 居 然 不 是 等 待 ， 想 想 也 是 醉 了 …… 


唤醒 的 方法 非常 类 似 ， 同 样 通过 UiDevice， 如 下 。 





void wakeUp () 











该 方法 提供 “唤醒 ”， 如 果 屏 幕 是 唤醒 状态 则 没有 任何 作用 。 














更 重要 的 是 ， 检 查 屏 幕 是 否 为 唤醒 状态 ， 这 很 重要 ， 如 下 。 











boolean isScreenOn() 





该 方法 检查 屏幕 是 否 为 唤醒 状态 。 





对 于 获取 设备 属性 ，monkeyrunner 通 过 MonkeyDevice 的 getProperty0 或 getSystemProperty0 方 法 进行 获取 。 





object getProperty (string key) 
object getSystemProperty (string key) 





而 UIAutomator 则 通过 UiDevice 很 细腻 地 将 其 分 为 以 下 几 个 部 分 。 


(1) 获取 产品 名 





String getProductName () 





该 方法 将 获取 产品 名 。 


(2) 获取 设备 对 象 





static UiDevice getInstance () 





该 方法 获取 一 个 Uldevice 实 例 对 象 。 


(3) 获取 显示 大 小 





Point getDisplaySizeDp () 





获取 dp (Bldevice-independent pixel) 格式 的 显示 大 小 。 





(4) 获取 显示 高 度 





int getDisplayHeight () 





该 方法 将 获取 显示 高 度 (以 像素 为 单位 ) 。 





(5) 获取 显示 宽度 





int getDisplayWidth () 








该 方法 将 获取 显示 宽度 (以 像素 为 单位 ) 。 


(6) 获取 当前 的 显示 角度 





int getDisplayRotation () 





该 方法 获取 当前 的 显示 角度 (如 0 度 、90 度 、180 度 、270 度 等 ) 。 





5.5.5 与 monkeyrunner 对 照 之 : 键 值 事件 





对 于 发 送 键 值 事件 ，monkeyrunner 通 过 MonkeyDevice 的 press() 方 法 发 送 name ( 即 keycode) 和 type ( 即 DOWN_AND_UP 等 ) 来 处 理 键 值 事件 ， 如 下 。 





void press(string name, dictionary type) 





而 UIAutomator 对 应 的 是 UiDevice 提 供 的 pressKeyCode() 方 法 ， 如 下 。 





boolean pressKeyCode (int keyCode, int metaState) 





该 方法 模拟 短 按键 盘 代码 ， 更 简洁 的 方法 如 下 。 





boolean pressKeyCode (int keyCode) 





该 方法 模拟 短 按键 盘 代 码 ， 直 接 传 入 keycode 即 可 。 
CE Oe AA! 


eo 区 别 在 后 面 ，UIAutomator 非 常 周到 地 通过 UiDevice 提 供 了 一 系列 按键 发 送 API。 
下 面 介绍 按键 发 送 AP1。 


(1) 发 送 <BACK> 键 





boolean pressHome () 





该 方法 模拟 短 按 <BACK> 键 。 


(2) 发 送 <HOME> 键 





boolean pressHome () 





该 方法 模拟 短 按 <HOME> 键 。 


(3) 发 送 <MENU> 键 





boolean PressMenu () 





该 方法 模拟 短 按 <MENU> 键 。 


(4) 发 送 <Enter> 键 





boolean pressEnter () 





该 方法 模拟 短 按 <Enter> 键 。 


(5) 发 送 删除 键 





boolean pressDelete() 





该 方法 模拟 短 按 删 除 键 。 





(6) 发 送 应 用 程序 按键 





boolean pressRecentApps () 














该 方法 模拟 短 按 最 近 应 用 程序 按键 (一 般 为 长 按 <HOME> 键 ) 。 








(7) 发 送 搜索 键 





boolean pressSearch () 





该 方法 模拟 短 按 搜索 键 


(8) 发 送 轨 迹 球 事件 





boolean pressDPadCenter () 





该 方法 模拟 轨迹 球 居中 。 





boolean pressDPadUp () 





该 方法 模拟 轨迹 球 向 上 。 





boolean pressDPadDown () 





该 方法 模拟 轨迹 球 向 下 。 





boolean pressDPadLeft () 





该 方法 模拟 轨迹 球 向 左 。 





boolean pressDPadRight () 





该 方法 模拟 轨迹 球 向 右 。 
55.6 ”人 无 我 有 之 : 屏幕 旋转 、 布 局 文件 
KEZE, BRZO o 


p CMM 比 后 不 难 发 现 ，UIAutomator 在 降低 难度 、 提 高 效率 、 可 读 性 和 精确 性 方面 的 确 做 了 大 量 的 工作 。 





当然 ，monkeyrunner 也 有 很 多 侧重 点 是 UIAutomator 不 重视 的 ， 不 过 这 些 不 是 本 章 重点 ， 下 面 一 起 来 看 看 UIAutomator 有 哪些 monkeyrunner 不 具备 的 优势 。 








先 来 看 看 屏幕 旋转 ， 在 实际 项 目 中 ， 每 当面 对 需要 自动 化 脚本 模拟 屏幕 旋转 进行 测试 时 ， 我 们 往往 找 不 到 对 应 方法 ， 只 能 依靠 很 多 不 稳定 的 蔡 代 方案 (比如 单独 将 横 屏 
后 再 运行 这 一 系列 用 例 等 ) ， 采 用 蔡 代 方案 最 大 的 风险 在 于 ， 一 旦 测试 人 员 忘记 预先 处 理 ， 或 者 测试 人 员 更 换 ， 则 非常 容易 造成 测试 遗漏 。 









































例 划分 出 来 ， 手 动 将 屏幕 旋转 


UIAutomator 不 仅 考 虑 到 屏幕 旋转 ， 还 考虑 到 具体 场景 中 的 相关 需求 一 如 果 没 有 相关 项 目 经 验 ， 是 很 难 想到 这 些 需 求 的 。 例 如 ， 设 备 自身 的 传感器 可 能 引起 自动 旋转 ， 这 将 造成 脚本 的 旋转 失效 (如 
































脚本 使 屏幕 转 为 横 屏 ， 但 设备 传感器 识别 后 自动 使 屏幕 转 回 竖 屏 ， 如 此 一 来 ， 脚 本 失效 ) 。 
































所 以 ， 首 先 需要 考虑 的 是 一 一 禁用 和 重启 传感器 。 这 里 通过 UiDevice 的 freezeRotation() 和 unfreezeRotation() 两 个 方法 实现 ， 如 下 。 




















(1) void freezeRotation() 











该 方法 禁用 传感器 ， 在 其 当前 旋转 状态 冻结 装置 物理 旋转 。 














(2) void unfreezeRotation() 


该 方法 重启 传感器 、 人 允许 物理 旋转 。 





$0, i. 在 禁用 传感器 的 基础 上 使 屏幕 转向 ， 主 要 分 几 步 ? 





… 不 知道 ! 
































接 下 来 ， 需 要 在 禁用 传感器 的 基础 上 使 屏幕 转向 ， 通 用 步骤 如 下 。 





























1) 禁用 传感器 。 











2) 模拟 屏幕 转 到 希望 的 方向 。 








3) 固定 位 置 。 




















这 里 通过 UiDevice 的 3 个 方法 setOrientationNatural0、setOrientationLeft0 和 setOrientation-Right() 模 拟 屏幕 转 到 默认 方向 、 向 左 转 或 向 右 转 ， 如 下 。 








(1) setOrientationNatural() 

















该 方法 禁用 传感器 、 模 拟 屏幕 转 到 其 默认 方向 、 固 定位 置 。 











(2) setOrientationLeft() 








该 方法 禁用 传感器 、 模 拟 设 备 向 左 转 、 固 定位 置 。 








(3) setOrientationRight() 























该 方法 禁用 传感器 、 模 拟 设 备 向 右 转 、 固 定位 置 。 





























最 后 ， 通 过 isNaturalOrientation() 方 法 检查 当前 屏幕 是 否 在 其 默认 方向 ， 如 下 。 








boolean isNaturalOrientation() 








该 方法 检查 设置 是 否 是 在 其 默认 方向 〈 即 自然 旋转 竖 屏 ) 上 。 



































另外 ， 实 际 项 目测 试 中 常常 需要 保存 当前 窗口 的 布局 结构 ， 以 便 对 窗口 变化 进行 对 比 和 恢复 等 。 这 里 ， 通 过 UiDevice 的 dumpWindowHierarchy() 方 法 将 当前 窗口 的 布局 结构 另存 为 文件 ， 如 下 。 














void dumpWindowHierarchy (String fileName) 











该 方法 将 当前 窗口 的 布局 结构 另存 为 文件 (存储 地 址 : /data/local/tmp) . 





setCompressedLayoutHeirarchy (boolean compressed) 

















该 方法 启用 或 禁用 布局 层次 压缩 。 























5.5.7” 人 无 我 有 之 : 获取 包 名 、 应 用 名 和 通知 栏 























在 monkeyrunner 中 ， 通 过 一 系列 手段 (包括 命令 行 、SL4A 工 具 等 ) 去 获取 包 名 和 应 用 名 ， 而 在 UIAutomator 里 则 变 得 十 分 简单 一 一 通过 UiDevice 的 getCurrentPackageName() 和 
getCurrentActivityName() 方 法 直接 获取 ， 如 下 。 











(1) string getCurrentPackageName() 








该 方法 获取 当前 应 用 的 包 名 。 





(2) string getCurrentActivityName() 
































该 方法 获取 当前 应 用 的 应 用 名 。 
e» 


全 之 前 弄 这 个 把 我 整 得 烦 的 不 行 ， 现 在 好 了 1! 


go, 在 实际 项 目 中 ， 还 有 一 个 通过 手势 操作 极 易 出 错 的 点 : 通知 栏 。 咱 们 一 起 分 析 一 下 ! 
































如 果 通 过 手势 操作 ， 很 容易 被 设备 误 识别 为 一 个 简单 的 屏幕 向 下 手势 (而 不 是 自 项 向 下 手势 ) ， 而 很 多 设备 的 普通 向 下 手势 匹配 了 其 他 开关 (如 有 的 设备 匹配 的 是 弹出 菜单 ， 有 的 设备 匹配 最 近 打开 应 
3) ， 这 样 极 易 造 成 脚本 出 错 。 



























































作为 实战 型 自动 化 脚本 框架 ，UIAutomator 自 然 需要 考虑 到 方方面面 ， 这 里 通过 UiDevice 的 openNotification() 方 法 直接 打开 通知 栏 ， 并 通过 openQuicksettings() 方 法 开启 快速 设置 ， 如 下 。 















































(1) boolean openNotification() 
该 方法 直接 开启 通知 栏 。 


(2) boolean openQuickSettings() 





该 方法 直接 打开 快速 设置 。 


55.8 ”人 无 我 有 之 : 获取 对 象 属性 











在 与 monkeyrunner 对 照 时 我 们 提 到 UIAutomator 获 取 设 备 属性 方法 ， 不 过 ， 在 自动 化 实战 中 ， 比 获取 设备 属性 更 重要 的 是 获取 捕获 的 控件 对 象 属 








性 。 











首先 ， 自 然 是 获取 该 控件 对 象 的 包 名 和 类 名 ， 这 是 通过 UiObject 的 getPackageName0 和 getClassName() 方 法 实现 的 ， 如 下 。 








String getPackageName () 








此 方法 获得 对 象 包 名 属性 的 包 名 。 





String getClassName () 








此 方法 获得 对 象 类 名 属性 的 类 名 。 


Qi 这 里 不 是 获取 当前 应 用 的 包 名 和 应 用 名 ， 而 是 获取 当前 控件 的 包 名 和 类 名 。 


除了 API 名 不 同 外 ， 大 家 不 难 发 现 获取 应 用 的 包 名 和 应 用 名 的 API 来 自 UiDevice， 而 获取 当前 控件 的 包 名 和 类 名 的 API 则 来 自 UiObject。 





接 下 来 ， 就 是 获取 该 控件 对 象 的 几 种 属性 : 控件 描述 (getContentDescription0) 、 控 件 文本 (getTextQ) 和 控件 坐标 (getBounds0) ， 如 下 。 





String getContentDescription () 





该 方法 获取 控件 对 象 的 描述 属性 。 








String getText () 





该 方法 获取 控件 对 象 的 文本 属性 。 








Rect getBounds () 








该 方法 获取 控件 对 象 的 坐标 属性 (这 里 返回 的 是 控件 左上 角 和 右 下 角 坐标 ) 。 





代码 清单 5-6 ”获取 控件 对 象 文 本 





// 捕 获 bugben 文 本 框 1 
UiObject getbugben_tvl = new UiObject (new 

UiSelector () .className ("android.widget.TextView")); 
// 获 取 文 本 框 1 文 本 


String bugben tvl text = getbugben tvl.getText(); 








再 下 来 ， 深 入 研究 获取 控件 对 象 的 其 他 方式 : 通过 父 类 (上 一 级 控件 ) 获取 该 控件 (getFromParent() ， 或 通过 该 控件 获取 其 子 类 (下 一 级 控件 ) 及 子 类 控件 数 (下 一 级 控件 数 ) , MIT. 





UiObject getFromParent (UiSelector selector) 





该 方法 通过 控件 的 父 类 (上 一 级 控件 ) 获取 该 控件 。 





UiObject getChild(UiSelector selector) 








该 方法 通过 该 控件 获取 其 子 类 (下 一 级 控件 ) 。 





int getChildCount () 














该 方法 用 于 获取 下 一 级 控件 数 ， 以 便 递归 获取 下 级 控件 中 目标 控件 对 象 。 








然后 ， 是 整个 可 见 视图 的 范围 ， 这 里 通过 getVisibleBounds() 方 法 返回 视图 范围 。 





























Rect getVisibleBounds () 








IR 


该 方法 返回 可 见 视图 的 范围 ( 若 视 图 的 部 分 是 可 见 的 ， 将 只 返回 可 见 部 分 的 范围 ) 。 

















fe 
全 % 对 了 ， 有 关于 控件 自身 属性 的 API 吗 ? 


85, ... 该 控件 是 否 可 用 、 是 否 被 勾 选 、 是 否 支 持 长 按 、 是 否 支持 滚动 等 ， 对 吧 ? 必须 有 啊 ! 





针对 控件 自身 属性 的 系列 API 如 下 。 


(1) boolean isEnabled() 





该 方法 检查 对 象 的 enabled 属 性 是 否 为 true。 


(2) boolean isCheckable() 





该 方法 检查 对 象 的 checkable 属 性 是 否 为 true。 


(3) boolean isChecked() 








该 方法 检查 对 象 的 checked 属 性 是 否 为 true。 





(4) boolean isClickable() 


该 方法 检查 对 象 的 clickable 属 性 是 否 为 true。 





(5) boolean isFocusable() 





该 方法 检查 对 象 的 focusable 属 性 是 否 为 true。 


(6) boolean isFocused() 





该 方法 检查 对 象 的 focused 属 性 是 否 为 true。 


(7) boolean isLongClickable() 





该 方法 检查 对 象 的 longclickable 属 性 是 否 为 true。 


(8) boolean isScrollable() 





该 方法 检查 对 象 的 scrollable 属 性 是 否 为 true 


(9) boolean isSelected() 








该 方法 检查 对 象 的 selected 属 性 是 否 为 true。 





检查 对 象 的 checkable 属 性 示例 ， 如 代码 5-7 所 示 。 





代码 清单 5-7 对象 的 checkable 属 性 确认 开关 是 否 开启 


// xuben: 声明 开关 对 象 
UiObject bugben switch = new UiObject (new 
7 UiSelector () .className ("android.widget.Switch")); 
// xuben: 如 果 开 关 是 开 ， 则 点 击 关 闭 
if (bugben switch.isChecked()){ 
bugben switch.click(); 
} 


最 后 ， 还 有 一 个 值得 一 提 的 API: getSelector0， 如 下 。 


final UiSelector getSelector () 





该 方法 通过 UiSelector 对 象 对 控件 进行 定位 。 


这 就 引入 了 下 节 内 容 一 一 强大 的 控件 筛选 器 : UiSelector。 


5.5.9 ”强大 的 控件 筛选 器 : UiSelector 








上 节 提 到 ， 通 过 UiObject 获 取 控件 对 象 属性 ， 然 后 通过 UiSelector 按 照 一 定 的 条 件 筛选 出 界面 上 符合 条 件 的 控件 。 














我 们 知道 ， 对 控件 筛选 无 外 乎 是 通过 文本 、 描 述 、 类 名 ( 包 名 ) 、 索 引 、 控 件 1D 或 一 些 特 有 的 属性 进行 ， 目 的 就 是 确定 控件 的 唯一 性 ， 以 确保 脚本 的 稳定 性 和 可 移植 性 。 





i» 
人 《既然 需要 这 些 控件 信息 ， 那 么 通过 哪些 方法 获取 这 些 信息 进 行 定位 呢 ? 


$9 ,, 方式 为 3 种 : 字符 串 匹 配 、 字 符 串 包含 或 正则 表达 式 。 


一 般 获 取信 息 定位 的 3 种 方式 。 








1) 字符 串 匹配 : 即 通过 该 属性 的 字 串 (或 开始 字 串 ) 定位 匹配 控件 。 























2) 字符 串 包含 : 即 通过 该 属性 的 字 串 中 某 一 部 分 字符 串 进行 控件 筛选 (对 于 一 些 特定 上 且 唯 一 的 标识 ， 该 方法 可 使 得 脚本 稳定 性 更 强 ) 。 








3) 正则 表达 式 : 通过 正则 表达 式 进 行 匹配 。 





首先 看 文本 ， 这 里 提供 了 3 个 方法 : 通过 开始 字 串 匹配 (textStartsWith()) 、 通 过 字 串 包含 (textContains()) 和 通过 正则 表达 式 textMatches0， 如 下 。 











(1) textStartsWith(string text) 


该 方法 通过 文本 (开始 字 串 匹配 ) 方式 进行 控件 筛选 。 











(2) textContains(string text) 


该 方法 通过 文本 ( 字 串 包含 ) 方式 进行 控件 筛选 。 





(3) textMatches(string regex) 





该 方法 通过 文本 正则 表达 式 ) 方式 进行 控件 筛选 。 


再 来 看 描述 ， 也 是 这 3 类 方法 ， 如 下 。 





(1) description(string desc) 


In 


该 方法 通过 描述 ( 字 串 匹配 ) 方式 进行 控件 筛选 。 











(2) descriptionStartsWith(string desc) 





该 方法 通过 描述 (开始 字符 匹配 ) 方式 进行 控件 筛选 。 








(3) descriptionContains(string desc) 


该 方法 通过 描述 ( 字 


REA) 方式 进行 控件 筛选 。 





(4) descriptionMatches(string regex) 





该 方法 通过 描述 (正则 表达 式 ) 方式 进行 控件 筛选 。 





接 下 来 是 类 名 和 包 名 ， 





除了 通过 字 串 和 正则 表达 式 外 ， 还 可 对 该 控件 的 子 控件 和 父 控件 进行 匹配 








(1) className(string className) 


该 方法 通过 类 名 (F 





串 匹 配 ) 方式 进行 控件 筛选 。 








(2) classNameMatches(string regex) 


该 方法 通过 类 名 (正则 表达 式 ) 方式 进行 控件 筛选 。 


(3) packageName(string name) 


该 方法 通过 包 名 (F 


串 匹 配 ) 方式 进行 控件 筛选 。 











(4) packageNameMatches(string regex) 


该 方法 通过 包 名 (正则 表达 式 ) 方式 进行 控件 筛选 。 


(5) childSelector(UiSelector selector) 


该 方法 通过 定位 子 类 方式 进行 控件 筛选 。 





(6) fromParent(UiSelector selector) 


该 方法 通过 定位 父 类 方式 进行 控件 筛选 。 


然后 是 索引 和 实例 ， 很 简单 ， 如 下 。 





(1) index(int index) 


该 方法 通过 索引 方式 进行 控件 筛选 。 


(2) instance(int instance) 





该 方法 通过 实例 方式 进行 控件 筛选 。 


Qi 索引 是 指 按照 当前 页 面 的 控件 所 在 控件 树 的 位 置 进 行 定位 ， 而 实例 (instanceQ) 则 表示 在 一 定 的 搜索 结果 下 ， 获 取 的 子 元 素 集 中 的 第 几 个 元 素 《〈 即 按 元 素 列表 中 的 编 


然后 是 控件 ID， 也 分 为 通过 ID 和 通过 正则 表达 式 两 种 ， 如 下 。 


(1) resourceld(string id) 


该 方法 通过 控件 1D 方 式 进行 控件 筛选 。 





(2) resourceldMatches(string regex) 


该 方法 通过 控件 ID (正则 表达 式 ) 方式 进行 控件 筛选 。 


， 如 下 。 











最 后 是 通过 该 控件 特有 的 属性 ， 如 可 勾 选 、 可 点 击 、 可 滚动 、 可 选择 、 可 长 按 和 当前 焦点 等 特殊 


(1) checked(boolean val) 





该 方法 通过 可 义 选 属性 方式 进行 控件 筛选 。 


(2) clickable(boolean val) 





该 方法 通过 可 点 击 属性 方式 进行 控件 筛选 。 





(3) scrollable(boolean val) 





该 方法 通过 可 滚动 属性 方式 进行 控件 筛选 。 


(4) selected(boolean val) 





该 方法 通过 可 选择 属性 方式 进行 控件 筛选 。 





(5) longClickable(boolean val) 


该 方法 通过 长 按 属性 方式 进行 控件 筛选 。 


(6) enabled(boolean val) 








该 方法 通过 启用 属性 方式 进行 控件 筛选 。 














(7) focusable(boolean val) 

















该 方法 通过 焦点 属性 方式 进行 控件 筛选 。 


(8) focused(boolean val) 





属性 辅助 定位 一 个 控件 ， 如 下 。 


号 


ab 











该 方法 通过 当前 焦点 属性 方式 进行 控件 筛选 。 


5.5.10 “给 力 ”的 控件 定位 器 : UiCollection 














UiCollection 继 承 自 UiObject， 所 以 它 返 回 的 都 是 UiObject 对 象 ， 而 抛 出 的 异常 也 都 是 UiObjectNotFoundException。UiCollection 一 般 与 UiSelector 连 用 ， 用 于 枚 举 一 个 容器 的 用 户 界面 元 素 计数 ， 
或 按照 子 元 素 的 文本 或 描述 条 件 获取 子 元 素 对 象 。 












































简单 地 说 ， 就 是 先 通过 UiSelector 进 行 控 件 筛选 ， 但 Uiselector 有 时 只 能 筛选 出 一 个 控件 集 ( 即 所 有 满足 UiSelector 条 件 的 控件 集合 ) ， 此 时 需要 通过 UiCollection 从 控件 集中 根据 一 定 条 件 确定 具体 的 
控件 。 


1) 通过 UiSelector 进 行 控件 筛选 。 


2) 符合 UiSelector 选 择 条 件 的 所 有 控件 组 成 一 个 控件 集合 。 





3) 通过 UiCollection 以 递归 的 方式 在 UiSelector 的 控件 集合 中 进行 二 次 搜索 。 

4) 找 出 唯一 满足 条 件 的 目标 控件 。 

s» 

人 5 其 实 大 白话 就 一 句 : UiSelector 就 是 海 选 评委 ， 而 UiCollection 是 复赛 评委 ， 能 否 赢得 总 冠军 关键 还 是 要 看 复赛 评委 是 否 愿意 为 你 转身 。 
例如 ，getChildByDescription() 方 法 就 是 从 Uiselector 筛 选 出 的 控件 集中 根据 描述 ( 即 Description) 准确 定位 到 目标 控件 ， 如 下 。 

(1) 获取 符合 条 件 的 子 控件 数量 


int getChildCount (UiSelector childPattern) 





该 方法 通过 描述 定位 符合 条 件 的 子 元 素 。 
参数 详细 说 明 如 下 。 

childPattern， 选 择 条 件 。 

返回 : 符合 条 件 的 子 控件 数量 。 


(2) 通过 描述 进行 控件 定位 





UiObject getChildByDescription(UiSelector childPattern, String text) 





该 方法 通过 描述 定位 符合 条 件 的 子 元 素 。 
参数 详细 说 明 如 下 。 

+ childPattern，UiSelector 从 子 元 素 中 的 选择 条 件 。 

“ text， 从 搜索 出 的 元 素 中 再 次 用 文本 条 件 搜索 元 素 。 
返回 : UiObject 对 象 。 
抛 出 异常 : UiObjectNotFoundException, 


(3) 通过 文本 进行 控件 定位 





UiObject getChildByText (UiSelector childPattern, String text) 





该 方法 通过 文本 定位 符合 条 件 的 子 元 素 。 
参数 详细 说 明 如 下 。 
.childPattern ，UiSelector 从 子 元 素 中 的 选择 条 件 。 
“text， 从 搜索 出 的 元 素 中 再 次 用 文本 条 件 搜索 元 素 。 
返回 : UiObject 对 象 。 
抛 出 异常 : UiObjectNotFoundException, 


(4) 通过 实例 进行 控件 定位 





UiObject getChildByInstance (UiSelector childPattern, int instance) 





该 方法 通过 实例 定位 符合 条 件 的 子 元 素 。 
参数 详细 说 明 如 下 。 

:childPattern ， 从 子 集 搜索 的 条 件 。 

“instance， 再 次 从 搜索 的 子 集中 用 实例 搜索 定位 想 要 的 元 素 。 
返回 : UiObject 对 象 。 


抛 出 异常 : UiObjectNotFoundException, 


5.5.11 无敌 的 滚动 : UiScrollable 


+ ra. 屏幕 滚动 都 有 哪些 方式 ? 


oi 


性 还 能 有 哪些 ， 无 外 乎 是 向 前 、 后 、 左 、 右 四 面 滚 。 


$9, usn, 不 过 对 于 自动 化 而 言 就 没 这 么 简单 。 比 如 你 希望 滚 到 某 个 列表 子 元 素 ， 怎 么 确保 精准 ? 
再 比如 你 希望 滚 到 某 个 对 象 ， 怎 么 办 ? 


还 有 ， 如 何 设置 最 大 滚动 次 数 ? 如何 设置 滚动 方向 ?如 何 快速 滚动 ? 


SG, Hl RAT RAR AG Dh ik RG RL 





前 面 说 到 ，UiCollection 继 承 自 UiObject， 而 UiScrollable 则 继承 自 UiCollection， 专 门 用 来 表示 可 以 滑动 的 界面 元 素 。 先 来 看 看 最 常用 





的 一 一 滚动 到 某 个 对 象 ， 如 下 。 





boolean scrollIntoView(UiObject obj) 




















该 方法 实现 滚动 到 目标 元 素 所 在 位 置 ， 并 尽 可 能 使 其 位 于 屏幕 正中 位 置 。 





boolean scrollIntoView(UiObject obj) 




















该 方法 实现 滚动 到 目标 对 象 所 在 位 置 ， 并 尽 可 能 使 其 位 于 屏幕 正中 位 置 。 


SERA A AAA (selector) 或 目标 对 象 (obj) ， 但 有 时 我 更 希望 直接 定位 到 某 个 文本 对 象 (如 text) ， 有 办 法 吗 ? 


$6, ,. 


直接 定位 到 某 个 文本 对 象 ， 方 法 如 下 。 





boolean scrollTextIntoView(String text) 




















该 方法 实现 滚动 到 文本 对 象 所 在 位 置 ， 并 尽 可 能 使 其 位 于 屏幕 正中 位 置 ， 如 代码 清单 5-8 所 示 。 


代码 清单 5-8 ”滚动 到 巴 哥 奔 对 象 





// xuben: 将 滚动 方向 恢复 为 纵向 滚动 
listScrollable.setAsVerticalList (); 

// xuben: 滚动 到 巴 哥 奔 对 象 
listScrollable.scrollTextIntoView (" 微 信号 : CA"); 





当然 还 有 直接 定位 到 某 个 描述 对 象 ， 如下。 





boolean scrollDescriptionIntoView (String text) 




















该 方法 实现 滚动 到 描述 所 在 位 置 ， 并 尽 可 能 使 其 位 于 屏幕 正中 位 置 。 
< 那 如 果 我 希望 直接 滚动 到 开始 位 置 或 结束 位 置 呢 ? 
| eT 


直接 滚动 到 开始 位 置 或 结束 位 置 ， 如 下 。 





boolean scrollToBeginning (int maxSwipes) 





该 方法 按照 设 定 的 最 大 滑动 距离 滚动 到 开始 位 置 。 





boolean scrollToBeginning(int maxSwipes, int steps) 





该 方法 实现 按照 设 定 的 最 大 滑动 距离 和 滑动 次 数 滚动 到 开始 位 置 。 





boolean scrollToEnd (int maxSwipes) 





该 方法 按照 设 定 的 最 大 滑动 距离 滚动 到 结束 位 置 。 





boolean scrollToEnd(int maxSwipes, int steps) 





该 方法 实现 按照 设 定 的 最 大 滑动 距离 和 滑动 次 数 滚动 到 结束 位 置 。 
人 明白 了 ， 不 过 如 果 我 事先 并 不 确定 需要 滚动 的 UiObiject 对 象 ， 该 如 何 获取 精确 的 子 元 素 ? 


E cu ad iocis 过 ， 如 通过 描述 定位 符合 条 件 的 子 元 素 。 


通过 描述 定位 符合 条 件 的 子 元 素 ， 如 下 。 





UiObject getChildByDescription(UiSelector childPattern, String text) 





该 方法 通过 描述 定位 符合 条 件 的 子 元 素 。 











这 里 还 可 用 到 另 一 个 重 载 方 法 ， 如 下 。 











UiObject getChildByDescription(UiSelector childPattern, String text, boolean allowScrollSearch) 











该 方法 增加 了 allowScrollSearch 参 数 ， 以 确定 目标 对 象 是 否 允 许 滚动 查找 。 

















相应 的 ， 通 过 文本 定位 方法 (getChildByText0) 也 有 对 应 的 重 载 方法 。 





UiObject getChildByText (UiSelector childPattern, String text, boolean allowScrollSearch) 





该 方法 实现 是 否 允许 滚动 获取 符合 UiSelector 条 件 与 文本 条 件 的 UiObject 对 象 。 

















例如 ， 希 望 通过 滚动 捕获 bugben 对 象 (bugben 对 象 本 身 也 具有 人 允许 滚动 查找 属性 ) ， 如 代码 清单 5-9 所 示 。 











代码 清单 5-9 ”滚动 捕获 bugben 对 象 





// xuben: 获取 滚动 元 素 对 象 
UiScrollable listScrollable-new UiScrollable (new UiSelector ().scrollable (true) ); 
// zuben: 获取 符合 条 件 的 子 元 素 对 象 
UiObject bugbenObj = listScrollable.getChildByDescription (new 
UiSelector().className ("android.widget.TextView"), "bugben", true); 
// xuben: 点 击 等 待 新 界面 出 现 
bugbenObj . clickAndWaitForNewWindow(); 





E] 
全 明白 了 ， 如 果 该 对 象 本 身 并 不 具备 滚动 查找 属性 的 话 ， 传 入 的 参数 就 应 该 是 ase， 对 吧 ? 
9? 

是 的 ， 现 在 你 算是 基本 掌握 如 何 直接 滚动 到 特定 对 象 的 方法 了 ! 


EC] 
全 % 嗯 ， 精 准 滚动 学 会 了 ， 那 非 精 准 滚 动 呢 ? 比如 前 、 后 、 左 、 右 各 方向 随意 滚动 ? 





好 ， 下 面 咱们 来 看 看 如 何 向 前 、 后 滚动 吧 ! 

向 前 、 后 滚动 ， 如 下 。 
(1) boolean scrollForward() 

该 方法 实现 向 前 滚动 (默认 步 长 为 55) . 
(2) boolean scrollForward(int steps) 

该 方法 实现 自 定义 步 长 向 前 滚动 。 


(3) boolean scrollBackward(int steps) 





该 方法 实现 自 定义 步 长 向 后 滚动 。 





(4) boolean scrollBackward() 


该 方法 实现 向 后 滚动 (默认 步 长 为 55) 。 





什么 只 有 向 前 和 向 后 滚动 ， 如 果 我 希望 向 左 或 向 右 滚动 咋 办 ? 
BS sia, 这 里 就 需要 用 到 另外 两 个 API: 设置 滚动 方向 。 
设置 滚动 方向 API， 如 下 。 

(1) setAsHorizontalList() 

该 方法 实现 将 滚动 方向 设置 为 横向 。 

(2) setAsVerticalList() 

该 方法 实现 将 滚动 方向 设置 为 纵向 。 

fe 

全 《我 要 的 是 向 左 或 向 右 滚动 ， 你 给 我 个 模 向、 纵向 滚动 是 什么 意思 ? 


9o, 难道 你 不 懂得 变通 吗 ? 有 了 横向 、 纵 向 滚动 不 就 可 以 实现 向 左 、 向 右 滚动 。 





例如 ， 我 们 希望 向 左 滚动 两 次 然后 滚动 到 巴 哥 奔 ， 如 代码 清单 5-10 所 示 。 


代码 清单 5-10 ”各 种 滚动 





UiScrollable listScrollable = new UiScrollable (new UiSelector().scrollable (true)); 
// xuben: 设置 滚动 方向 为 横向 滚动 
listScrollable.setAsHorizontalList (); 

// xuben: 向 左 滚动 一 次 (横向 向 前 即 为 向 左 ) 
listScrollable.scrollForward(); 

// xuben: 再 向 左 滚动 一 次 
listScrollable.scrollForward(); 

// xuben: 将 滚动 方向 恢复 为 纵向 滚动 
listScrollable.setAsVerticalList (); 

// xuben: 滚动 到 巴 哥 奔 
listScrollable.scrollTextIntoView (" 微 信号 : CA"); 





fo 
Sk, Né T! 不 过 为 什么 向 前 、 向 后 滚动 的 默认 步 长 是 55 啊 ? 感觉 好 慢 了 ， 有 种 累 觉 不 爱 的 感觉 。 


Be sas, 干脆 自己 设置 步 长 得 了 。 不 过 ， 的 确 也 有 快速 滚动 的 方法 ， 你 看 看 适 不 适用 吧 ! 
快速 滚动 ， 如 下 。 
(1) boolean FlingForward() 
该 方法 实现 快速 向 前 滑动 (默认 步 长 为 5) . 
(2) boolean FlingBackward() 
该 方法 实现 快速 向 后 滑动 (默认 步 长 为 5) 。 
除了 快速 向 前 、 向 后 滚动 外 ， 还 可 快速 滚动 到 顶 (起 始 位 置 ) 或 快速 滚动 到 底 (结束 位 置 ) BUT. 
(1) boolean FlingToBeginning(int maxSwipes) 
该 方法 实现 自 定义 滑动 次 数 快速 滚动 到 顶 (默认 步 长 为 5) 。 
(2) boolean FlingToEnd(int maxSwipes) 


该 方法 实现 自 定义 滑动 次 数 快速 滚动 到 底 (默认 步 长 为 5) . 





快速 滚动 示例 如 代码 清单 5-11 所 示 。 





代码 清单 5-11 ”快速 滚动 





// xuben: 获取 滚动 对 象 

UiScrollable listScrollable = new UiScrollable (new UiSelector() .scrollable (true)); 
// xuben: 快速 滚动 到 页 面 底部 (只 需 滑 动 3 次 ) 

listScrollable.flingToEnd (3); 


LP ! 还 有 个 问题 ， 如 何 确保 传 入 的 滚动 次 数 不 超过 最 大 值 ? 
eo 问 得 好 ， 所 以 咱们 还 需要 获取 或 设置 最 大 滚动 次 数 。 
获取 或 设置 最 大 滚动 次 数 ， 如 下 。 
(1) int getMaxSearchSwipes() 
该 方法 实现 获取 执行 搜索 滚动 过 程 中 的 最 大 滚动 次 数 。 


(2) UiScrollable setMaxSearchSwipes(int swipes) 





该 方法 实现 设置 执行 搜索 滚动 过 程 中 的 最 大 滚动 次 数 。 
fe 
从 在 实际 项 目 中 ， 我 们 常常 会 遇 到 一 个 问题 : 有 的 区 域 并 不 支持 滑动 ， 如 果 脚本 里 是 从 最 边缘 开始 滑动 则 会 导致 脚本 无 响应 ， 这 该 怎么 办 ? 


Oi 区 域 进行 校准 ， 简 单 地 说 ， 就 是 获取 非 滑动 区 域 CAER) 在 整个 屏幕 中 的 占 比 ， 然 后 对 整个 滑动 区 域 进行 调整 。 


对 滑动 区 域 进行 校准 ， 如 下 。 





(1) double getSwipeDeadZonePercentage() 











该 方法 获取 滑动 盲区 在 整个 屏幕 中 所 占 百分比 。 








(2) UiScrollable setSwipeDeadZonePercentage(double swipeDeadZonePercentage) 























该 方法 设置 滑动 盲区 在 整个 屏幕 中 所 占 百分比 。 














5.5.12 ”疯狂 的 监听 器 : UiWatcher 





KAMAL? 如 果 没有 监听 会 怎么 样 ? 
BS, rosas, 我 们 就 不 知道 事件 何 时 被 触发 。 
如 果 没有 上 监听， 我 们 就 不 知道 什么 时 候 响应 最 合适 。 


如 果 没 有 监听 ， 我 们 就 陷入 到 漫长 的 等 待 中 无 法 自拔 ， 永 远 不 知道 对 方 是 否 已 经 收 到 。 





全 监听 不 就 是 注册 一 个 监听 器 吗 ? 为 什么 还 单独 作为 一 节 来 聊 ? 
99. inso 了 监听 菜 个 事件 ， 如 果 该 事件 无 需 监 听 了 ， 是 不 是 该 移 除 ? 


当 监 听 器 很 多 时 ， 如 果 都 要 运行 ， 是 不 是 需要 一 个 强制 运行 所 有 监听 器 的 方法 ? 


当 监听 器 被 触发 过 ， 是 不 是 需要 重 置 监听 器 ? 


另外 ， 怎 么 知道 是 否 有 监听 器 被 触发 过 ? 或 者 更 进一步 ， 怎 么 知道 某 个 特定 的 监听 器 被 能 发 过 ? 





LA, REPEAL ATT, ARERR BT. 











监听 器 相关 API 均 来 自 UiDevice， 让 我 们 先 来 看 看 如 何 注册 一 个 监听 器 ， 如 下 。 








(1) void registerWatcher(string name,UiWatcher watcher) 

该 方法 实现 注册 一 个 监听 器 (当前 运行 指定 步骤 被 打 断 时 将 处 理 中 断 异 常 ) 。 
(2) void removeWatcher(string name) 

该 方法 实现 移 除 之 前 注册 的 监听 器 。 


(3) void resetWatcherTriggers() 





该 方法 实现 重 置 一 个 监听 器 。 
(4) void runWatchers() 
该 方法 实现 强制 运行 所 有 的 监听 器 。 
(5) boolean hasAnyWatcherTriggered() 
该 方法 实现 检查 是 否 有 监听 器 触发 过 。 
(6) boolean hasWatcherTriggered(string watcherName) 


该 方法 实现 检查 某 个 特定 的 监听 器 是 否 触发 过 。 





// xuben: 捕获 提交 按钮 并 按 下 等 待 跳 转 
UiObject subbutton = new UiObject (new UiSelector () .text (" 提 交 ") ) 7 





监听 器 示例 如 代码 清单 5-12 所 示 。 


代码 清单 5-12 ”监听 器 示例 





// xuben: 假设 当前 界面 没有 提交 按钮 ， 则 需要 监听 其 弹出 后 再 操作 
UiDevice.getInstance () .registerWatcher ("bugbensubmit", 
new UiWatcher() ( 

UiObject subbutton = new UiObject (new UiSelector().text ("jt z")); 


GOverride 
public boolean checkForCondition() ( 
if (subbutton.exists()) ( 


subbutton.clickAndWaitForNewWindow () ; 
return true; 
} 
return false; 
} 
} 
Jý 
// xuben: 运行 所 有 的 监听 
UiDevice.getInstance().runWatchers(); 
// xuben: 移 除 对 提交 按钮 的 监听 
UiDevice.getInstance () .removeWatcher ("bugbensubmit "); 
// xuben: 检查 监听 器 是 否 被 运行 过 
boolean bugbensubmit = UiDevice.getInstance () .hasWatcherTriggered ( 
" bugbensubmit") ; 
if (bugbensubmit == true) { 
System.out.println("bugbensubmit button has watched!"); 


} 
// xuben: 重 置 已 经 触发 过 的 监听 
UiDevice.getInstance () .resetWatcherTriggers () ; 





5.5.13 UlAutomator API 综 述 





< 人 % 学 到 这 里 ， 感 党 有 些 头 大 ， 奔 哥 你 帮 我 串 一 下 吧 ， 嘿 嘿 ! 


$6. 记 住 这 句 话 : UI 界面 能 操作 的 控件 对 象 都 可 称 为 UiObject， 它 是 所 有 对 象 类 的 父 类 ，UiCollection 和 UiScrollable 都 继承 自 它 。 




















这 一 切 都 与 具体 操作 相关 ， 然 而 ， 这 一 切 运行 的 基础 却 依赖 于 UIAutomator 用 例 运 行 框架 一 一 UlIAutomatorTestCase。 




















同 Instrumentation 一 样 ，UIAutomatorTestCase 也 继承 自 Junit， 确 切 地 说 ， 继 承 自 Junit3 中 的 TestCase 类 。 它 通过 Bundle 实 现 Android Activity 之 间 的 通信 ， 除 了 setUp0、tearDown()、 
getParams() 等 方法 外 ， 还 添加 了 getUiDevice() 等 方法 ， 以 便 在 测试 用 例 中 随时 调用 UIDevice 相 关 方 法 (如 锁 屏 、 唤 醒 、 键 值 发 送 、 获 取 包 名 和 应 用 名 、 屏 幕 旋 转 等 常用 的 设备 操作 方法 ) 。 





















































完整 总 结 如 图 5-7 所 示 。 

















人 5% 很 清晰 的 一 张 图 ， 每 一 块 主要 负责 的 东西 基本 了 解 了 ， 下 面 咱们 该 练 练 手 了 吧 1 











9o, 废话 少 说 ， 咱 们 开始 练 手 吧 ! 


5.6 ”更 简洁 的 脚本 撰写 
5.6.1 UIAutomator 界 面 捕 获 


B®. ia 们 创建 了 测试 项 目 ， 下 面 直接 开始 进行 界面 控件 捕获 吧 ! 


锁 屏 /唤醒 
键 值 发 送 


* UiDevice =; 人 截屏 
vincis 屏幕 旋转 布局 文件 


获取 包 名 和 应 用 名 通知 栏 
拖 搜 
£^ 
给 力 的 手势 aa 
| — 输入 点 击 和 长 按 
| * UiObject = 对象 操作 = 等 待 
| 2 获取 对 象 属性 
获取 子 类 


| | 文本 

|| 描述 

| | * UiSelector = 条 件 饰 选 =| 类 名 ( 包 名 ) 

| | 索引 

PT 控件 ID 

| | / 通过 UiSelector 进 行 控件 筛选 

|] / 符合 UiSelector 选 择 条 件 的 所 有 控件 组 成 一 个 控件 集合 

||| „~ MiCollection “控件 集合 =| 通 过 UiCollection 以 递归 的 方式 在 Uiselector 的 控件 集合 中 进行 二 次 搜索 
找 出 唯一 满足 条 件 的 目标 控件 


I 滚 到 某 个 列表 子 元 素 
用 滚 到 某 个 对 象 

| 设置 最 大 滚 到 次 数 
Il * UiScrollable - 滚动 对 象 设置 滚动 方向 

|l / 滑动 区 域 校准 

1 / 快速 滚动 


Es 重 置 监听 器 
* UiWatcher < 监听 器 a 运行 所 有 监听 器 
\ 监听 器 是 否 被 触发 


setUp() 
tearDown() 


* UiAutomatorTestCase “= 测试 用 例 = getParams() 
getUiDevice() 


图 5-7 UlAutomator API Z5 4& i 25 


























界面 ， 进 行 基本 控件 捕获 ， 如 图 5-8 所 示 。 











首先 ， 打 开 UIAutomator 并 进入 Bugben 应 


[ UI Automator Viewer 


gG. seuil CQ CO 17:24 
bugben 


请 在 下 框 中 输入 希望 修改 的 文字 : 


本 框 1 文字 : | Bugben 微 信 : EBERT | 





weve DugbenQQ:1971629467 


请 选择 文字 属性 : 
本 框 1 粗 细 : 





图 5-8 ”UIAutomatorViewer 编 辑 界面 捕获 




















@ 


次 ， 在 Bugben 编 辑 界 面 进行 输入 ， 并 捕获 控件 进行 文本 验证 ， 如 








5-9 所 示 。 














W UI Automator Viewer 









[com [o 0 17:25 


bugben 
请 在 下 框 中 输入 希望 修改 的 文字 : 
文本 框 1 文字 : P1517 


D ME 





文本 框 2 大 小 : 


BIOL 


图 5-9 ”UIAutomatorViewer 输 入 界面 捕获 








a A 
日 
E- (0) FrameLayout [0,0][1080, 1920] 
E LinearLa 0) 
(0) FrameLayout [0,75][1080,150] 
E3- (1) FrameLayout [0,150] 10680,1920] 
E (0) TableLayout [0,150][1080, 1920] 
(0) TextView: 请 在 下 框 中 输入 希望 修改 的 文字 : [0,15011080,231] 
(1) TableRow [0,231][1080,375] 
E- (2) TableRow [0,3751080,519] 
(3) TextView: 请 选择 文字 属性 : [0,519)[1080,600] 
由 -(4) TableRow [0,600(1080,744] 
E- (5) TableRow [0,744 1080,888] 
(6) Button: 3T [0,888] 1080, 1032] 








text 

resource-id 

class android. widget.LinearLayout 
package com.xuben.hellobugben 
content-desc 

checkable false 

checked false 

clickable false 

enabled true 

focusable false 

focused false 

scrollable false 

long-clickable false 

password false 

selected false 

bounds [0,0)[1080, 1920) 











+1 A 












a 
E3-(0) FrameLayout [0,0[1080,1920] 
- ((0)) LinearLayout [0,0][1080,1920] 
E- (0) FrameLayout [0,75][1080, 150) 
(0) TextView:bugben [12,77)(1068,145] 
E3- (1) FrameLayout [0,150][1080, 1920) 
& (0) TableLayout [0,150][1080, 1920) 
(0) TextView: 请 在 下 框 中 输入 希望 修改 的 文字 : [0,150Y1080,231] 
田 -(1) TableRow [0,231)[1080,375] 
由 -(2) TableRow [0,375)[1080,519] 
(3) TextYiew: 请 选择 文字 属性 : [0,519][1080,600] 
由 -(4) TableRow [0,600)[1080,744) 
四- (5) TableRow [0,744][1080,888] 
(6) Button, 提 交 [0,888][1080,1032] 
Node Detail 
index 0 
text 
resource-id 
class android. widget .LinearLayout 
package com.xuben.hellobugben 
content-desc 
checkable false 
checked false 
clickable false 
enabled true 
focusable false 
focused false 
scrollable false 
long-clickable false 
password false 
selected false 
bounds [0,01080,1920] 














E 
E 


[ 


后 ， 点 击 “ 提 交 ” 按 钮 跳 转 到 结果 输出 界 


e 


， 对 该 界面 结果 显示 进行 捕获 ， 如 








Bin 

















5-10 所 示 。 


E UI Automator Viewer 









@ = seuil CO S). 17:25 EA 
日 
E- (0) FrameLayout [0,0)[1080,1920] 
日 - (0) LinearLayout [0,0)(1080,1920] 
(0) FrameLayout [0,75][1080, 150] 
E (1) FrameLayout [0,150][1080, 1920) 
日-(0) View [0,1501 1080,1920] 
(0) TextView: EF [120,270][1080, 1920] 
920] 





1 











‘Node Detail 

index 1 

text 小 简洁 

resource-id com.xuben.hellobugben:id/myTextView02 
class android. widget. TextView 
package com.xuben.hellobugben 
content-desc 

checkable false 

checked false 

clickable false 

enabled true 

focusable false 

focused false 

scrollable false 

long-clickable false 

password false 

selected false 

bounds [480,630][1080,1920] 











5-10 ”UIAutomatorViewer 结 果 显 示 界 面 捕获 











$6. , Up KR fi Pst iB, Te ARAN SFR. 


在 UIAutomator 框 架 中， 测试 程序 与 待 测 程序 之 间 是 松 耦 合 关 系 一 一 也 就 是 说 ， 我 们 完全 不 需要 (也 没 办 法 ) 获取 待 测 程序 的 控件 ID， 而 是 纯 功能 地 对 控件 的 文本 (text) 、 描 述 (content-desc) 等 
信息 进行 识别 即 可 。 


p 果 是 纯 黑 金 测试 ， 我 们 无 法 知道 待 测 程序 的 包 名 ， 该 如 何 启动 待 测 程序 呢 ? 










































































官网 介绍 的 方法 是 利用 该 应 用 的 描述 属性 (Bücontent-description) ， 但 在 实际 项 目 中 ， 该 应 用 的 描述 属性 很 可 能 为 null， 甚 至 出 现 整个 应 用 列表 界面 无 法 捕获 的 情况 ， 此 时 ， 该 如 何 启动 待 测 程序 
呢 ? 








下 节 将 重点 说 明 。 





5.6.2 ”UIAutomator 应 用 启动 





Oppnommmentaionss 何 启动 应 用 吗 ? 






ea 





id Intent??? 








Instrumentation 启 动 应 用 ， 如 代码 清单 5-13 所 示 。 























代码 清单 5-13 Instrumentation 启 动 应 








// xuben: 启动 ChangeActivity 

Intent intent = new Intent(); 

intent.setClassName ("com.xuben.hellobugben", ChangeActivity.class.getName()); 
intent.setFlags (Intent.FLAG ACTIVITY NEW TASK); 

changeAutoTest =(ChangeActivity) getInstrumentation () .startActivitySync (intent); 





, Y 何 启动 应 用 呢 ? 


Sk, Rin 








UIAutomator 需 要 通过 如 下 命令 启动 应 用 。 

















am start -n "com.xuben.hellobugben/.ChangeActivity" 





那么 ， 这 串 命令 如 何 才能 在 UIAutomator 中 运行 呢 ? 





我 们 创建 如 下 方法 ， 如 代码 清单 5-14 所 示 。 


代码 清单 5-14 启动 应 用 





String testCmp = "com.xuben.hellobugben/.ChangeActivity"; 
// xuben: 启动 应 用 
private int startApp(String componentName) { 


StringBufer bugben sbufer - new StringBufer(); 
bugben sbufer.append("am start -n "); 
bugben sbufer.append (componentName) ; 
int ret - -1; 
try { 
Process process = Runtime.getRuntime () .exec (bugben sbufer.toString()); 
ret = process.waitFor (); n 
} 
catch(Exception e) ( 
e.printStackTrace(); 


return ret; 






























































不 难 发 现 ，UIAutomator 其 实 是 通过 命令 行进 行 应 用 启动 的 ， 回 想起 monkeyrunner 中 的 方法 device.startActivity(component) 直 接 启 动 应 用 ， 那 是 多 么 体贴 的 设计 啊 ! 
5.6.3 ”UIAutomator 控 件 捕 获 
OO 


fo 
全 % 额 ,界面 上 所 有 控件 都 要 捕获 啊 ， 等 等 ， 我 想 想 :…… 咱 们 还 是 列 个 list 吧 ! 
有 如 下 控件 需要 捕获 。 
1) 文本 框 1 和 文本 框 2。 


2 





单 选 框 1 (加 粗 、 不 加 粗 ) 和 单 选 框 2 UNS. XS). 





3) 提交 按钮 。 


4) 文本 1 结果 显示 和 文本 2 结果 显示 。 














下 面 我 们 一 个 一 个 来 ， 看 看 如 何 进行 捕获 ， 以 及 调用 哪些 API 进 行 获取 。 

















首先 来 看 文本 框 1， 文 本 框 1 捕获 截图 ， 如 图 5-11 所 示 。 

















对 应 树 状 菜单 ， 如 图 5-12 所 示 。 














late MEPHWAA SETZ EXE XC. : 


Bugben 微 信 : FS 





图 5-11 文本 框 1 界面 


—- (1) TableRow [0,231][1080,375] 
| t (0) TextView: 文本 框 1 文字 : [0,266][327,331] 


(1) EditText:Bugbenitia : ERF [327,23 





图 5-12 文本 框 1 节点 





而 相关 参数 ， 如 图 5-13 所 示 。 














- Node Detail 
index 

text 
resource-id 
class 
package 
content-desc 
checkable 
checked 
clickable 
enabled 
focusable 
focused 
scrollable 
long-clickable 
password 
selected 
bounds 


| 

Bugbentéía : BHF 
com.xuben.hellobugben:id/txt1 
android. widget. EditText 
com.xuben.hellobugben 


false 
false 
true 
true 
true 
true 
false 
true 
false 
false 
[327,231][966,375] 





图 5-13 文本 框 1 参数 








这 里 我 们 看 到 ， 该 控件 并 没有 描述 ( 即 content-desc 为 空 ) 。 一 般 情况 下 ， 开 发 人 员 都 不 会 特意 为 控件 专门 力 





0 上 描述 (RIESZ 


= 
& 


团 








队 提 出 要 求 并 在 特殊 情况 下 得 到 相应 的 支持 ) 。 























所 以 ， 我 们 可 通过 控件 文本 (text 项 ) 和 坐标 (bounds 项 ) 对 其 进行 捕获 ， 一 般 文本 更 加 稳定 ， 这 里 我 们 选 





文本 。 











对 应 API 比 较 简单 ， 直 接 通 过 UiSelector 的 text() 方 法 即 可 捕获 到 ， 如 下 。 




















// xuben: 捕获 文本 框 ] 并 赋值 
UiObject bugben etl = new UiObject (new UiSelector () .text ("Bugben 微 信 : 巴 哥 奔 ") ) 7 





相应 地 ， 文 本 框 2 也 类 似 ， 代 码 如 下 。 





// xuben: 捕获 文本 框 2 并 赋值 
UiObject bugben et2 = new UiObject (new UiSelector().text ("BugbenQQ:1971629467") ) ; 














然后 是 两 个 单 选 框 ， 我 们 先 来 看 第 一 个 ， 如 图 5-14 所 示 。 
对 应 树 状 菜单 ， 如 图 5-15 所 示 。 

















请 选择 文字 属性 : 
文本 框 1 粗细 : À 


c (9 TableRow [0,600][1080,744] 
(0) TextView: V AHELA : [0,600][327,665] 
B. (1) ih EU E m 








而 相关 参数 ， 如 图 5-16 所 示 。 











resource-id 
class 
package 
content-desc 
checkable 
checked 
clickable 
enabled 
Focusable 
focused 
scrollable 
long-clickable 
password 
selected 
bounds 


同样 没有 描述 (content-desc) ， 同 样 通过 文本 ， 如 下 。 


// xuben: 捕获 加 粗 选项 框 并 选择 
UiObject bugben bold = new UiObje 











是 不 是 似曾相识 ?这 两 种 控件 简直 没 区 别 嘛 ! 








对 于 字号 也 是 如 此 ， 如 下 。 


// x 
UiOb: 


uben: 捕获 大 号 选项 框 并 选择 
Í = new Ui 


ject bugben_big 











接 下 来 是 提交 按钮 ， 如 图 5-17 所 示 。 











对 应 树 状 菜单 ， 如 图 5-18 所 示 。 














Object (new UiSelector text 


Ü 

加 粗 
com,xuben.hellobuaben:id/bold 
android. widget.RadioButton 
com.xuben.hellobugben 


true 
False 
true 
true 
true 
False 
False 
False 
False 
False 
[327,600][537,744] 


5-16 单 选 框 1 参数 





提交 


图 5-17 提交 按钮 界面 





而 相关 参数 ， 如 图 5-19 所 示 。 











Node Detail 
index 

text 
resource-id 
class 
package 
content-desc 
checkable 
checked 
clickable 
enabled 
focusable 
focused 
scrollable 
long-clickable 
password 
selected 
bounds 


同样 没有 描述 (content-desc) ， 同 样 通过 文本 ， 如 下 。 





(6 | Buttor Jn: :提交 [i | 98 T [1 T 30 | 1032 


图 5-18 ”提交 按钮 节点 


6 

提交 
com.xuben.hellobugben:id/myButtonO1 
android. widget Button 
com.xuben.hellobugben 


false 
false 
true 
true 
true 
false 
false 
false 
false 
false 
[0,888][1080,1032] 





图 5-19 ”提交 按钮 参数 





// eh es Mec poii deed 


UiObjec (new UiSelector().text("jtz")); 

















点 击 提交 按钮 后 ， 界 面 将 跳 转 ， 我 们 需要 捕获 文本 1 和 文本 2 的 结果 显示 。 文 本 1 结果 显示 ， 如 图 5-20 所 示 。 








对 应 树 状 菜单 ， 如 图 5-21 所 示 。 




















公众 微 信 账号 : Bae 


E- (0) LinearLayout [0,0][1080,1920] 
由 - (0) FrameLayout [0,75][1080,150] 
日: (1) FrameLavout [0,150][1080,1920] 
E- (0) View D MEL M =. 








而 相关 参数 ， 如 图 5-22 所 示 。 











0 
EHF 
resource-id com. xuben.hellobugben:id/myTextViewO1 
class android.widget. TextView 
package com.xuben.hellobugben 
content-desc 
checkable false 
checked false 


clickable false 
enabled true 
focusable false 
focused false 
scrollable false 
long-clickable false 
password false 
selected false 
bounds [120,270](1080,1920] 





图 5-22 ”结果 显示 


ka 
Nd 


数 
9o, 果 显示 的 控件 如 何 捕获 呢 ? 

fe 

Sk RHO? 直接 通过 文本 ? 


到 这 里 ， 很 多 同学 就 想当然 地 认为 ， 也 可 通过 文本 (text 项 ) 去 捕获 控件 ， 如 下 。 





// xuben: 捕获 文本 框 ] 并 赋值 
UiObject bugben_tvl = new UiObject (new UiSelector () .text ("GFF") ); 





s» 
人 为 什么 不 能 这 样 做 呢 ? 


99, 为 这 里 的 文本 正好 是 咱们 要 验证 的 内 容 ， 如 果 直 接 通过 文本 去 捕获 ， 一 旦 验证 结果 非 该 文本 ， 则 程序 将 直接 抛 异常 ， 这 并 不 是 咱们 希望 看 到 的 结果 。 





此 时 ， 我 们 并 不 想 直接 通过 坐标 去 捕获 ， 毕 竟 这 样 稳定 性 太 差 ， 那 我 们 还 有 什么 方法 呢 ? 
对 ， 还 可 通过 index 或 instance。 先 试 试 index， 如 代码 清单 5-15 所 示 。 


代码 清单 5-15 ”通过 index 捕 获 控 件 





UiObject bugben tvl = new UiObject (new UiSelector () 
-className ("android.widget.LinearLayout") 
. index (0) 
.childSelector (new UiSelector () 
-className ("android.widget.FrameLayout") 
.index(0)) 





$6... 运行 一 下 看 看 。 
fe 
全 没有 捕获 到 ， 什 么 情况 ? 


根据 树 状 菜 单一 级 一 级 地 查看 ， 发 现 原来 此 时 的 index(0) 还 只 到 FrameLayout 这 一 级 ， 选 定 的 是 第 一 个 FrameLayout， 而 文本 1 的 显示 框 则 在 第 二 个 FrameLayout 下 的 第 一 个 TextView， 所 以 还 得 继续 
到 下 一 级 子 菜单 ， 如 代码 清单 5-16 所 示 。 

















代码 清单 5-16 ”精确 捕获 显示 文本 1 





UiObject bugben tvl = new UiObject (new UiSelector () 
.className ("android.widget.LinearLayout") 
.index (0) 
-childSelector (new UiSelector () 
-className ("android.widget.FrameLayout") 
.index(1)) 
-childSelector (new UiSelector () 
-className ("android.widget.TextView") 


.instance(0))); 





看 上 去 好 复杂 的 感觉 ， 的 确 没 有 Instrumentation 那 么 清晰 和 精准 ， 各 有 利弊 吧 ! 不 过 ， 好 在 熟悉 了 效率 也 会 渐渐 高 起 来 。 


对 于 文本 2 的 显示 ， 与 文本 1 的 唯一 区 别 在 于 它 是 第 二 个 instance， 即 instance(1)， 于 是 修改 后 如 代码 清单 5-17 所 示 。 








代码 清单 5-17 ”精确 捕获 显示 文本 2 





UiObject bugben tv2 = new UiObject (new UiSelector () 
7 -className ("android.widget.LinearLayout") 

. index (0) 
-childSelector (new UiSelector () 
-className ("android.widget .FrameLayout") 
. index (1) ) 
-childSelector (new UiSelector () 
.className ("android.widget.TextView") 
.instance(1))); 





5.64 _UIAutomator 控 件 操作 
E] 
全 改 对 控件 的 操作 该 以 何 种 顺序 呢 ? 


C 呵呵 ! 

对 控件 的 操作 我 们 也 按 此 顺序 进行 。 

1) 文本 框 1 和 文本 框 2。 

2) 单 选 框 1 (加 粗 、 不 加 粗 ) 和 单 选 框 2 UNS. XS). 
3) 提交 按钮 。 

4) 文本 1 结果 显示 和 文本 2 结果 显示 。 

首先 是 对 文本 框 1 的 操作 ， 如 代码 清单 5-18 所 示 。 


代码 清单 5-18 ”操作 文本 框 1 





// xuben: LAELIA PAT E 

String bugben txtl = "xiaojianjie"; 

// xuben: 先 判 断 文本 框 1 存在 且 可 用 

if(bugben etl.exists() && bugben etl.isEnabled()) 


// xuben: 点 击 文本 框 1 

bugben etl.click(); 

// xuben: 对 文本 框 1 赋 值 

bugben etl.setText (bugben txtl); 
} 
else { 

// xuben: 车 找 不 到 该 文本 框 ， 则 记录 log 

Log.e("txtl Error", "can not found bugben et1"); 
} 





文本 框 2 也 是 如 此 ， 这 里 就 不 重复 了 。 下 面 来 看 单 选 框 1 的 操作 ， 如 代码 清单 5-19 所 示 。 





代码 清单 5-19 ”操作 单 选 框 1 


// xuben: 点 击 加 粗 选 项 框 进行 选择 
if(bugben bold.exists() && bugben bold.isEnabled()) 
{ 
bugben bold.click(); 
} 
else { 
Log.e("bugben bold Error", "can not found 加 粗 "); 
} 

















然后 是 点 击 “ 提 交 ” 按 钮 ， 这 里 需要 注意 ， 点 击 完 后 界面 将 跳 转 ， 所 以 这 里 不 应 该 用 基本 的 click() 方 法 ， 而 应 该 通过 clickAndWaitForNewWindow() 方 法 等 待 跳 转 完成 ， 如 代码 清单 5-20 所 示 。 








代码 清单 5-20 ”操作 提交 按钮 


if(subbutton.exists() && subbutton.isEnabled()) 


{ 
subbutton.clickAndWaitForNewWindow () ; 


else { 


Log.e("subbutton Error", "can not found subbutton"); 
} 


最 后 是 文本 验证 ， 注 意 这 里 需要 通过 assertEquals() 方 法 进行 判断 ， 如 代码 清单 5-21 所 示 。 





代码 清单 5-21 ”文本 验证 





// xuben: 验证 文本 框 1 的 文本 
if(bugben tvl.exists() && bugben tvl.isEnabled()) 


{ 
assertEquals (bugben txtl, bugben_tvl.getText () .toString()); 


else { 
Log.e("bugben_tvl Error", "can not found bugben tv1"); 


l 





eo 的 确 很 零散 ， 咱 们 看 看 完整 项 目 代码 吧 ! 


5.655 Bugben 完 整 测试 项 目 





SrA, RARR A ARARA? 
© ou, 大 家 先 过 一 遍 ， 有 什么 不 明白 的 咱们 再 说 ! 
Bugben 完 整 测 试 项 目 ， 如 代码 清单 5-22 所 示 。 


代码 清单 5-22 Bugben 完 整 测试 项 目 





package com.xuben.hellobugben.test; 
import java.io.File; 
import android.util.Log; 
import com.android.UIAutomator.core.UiDevice; 
import com.android.UIAutomator.core.UiObject; 
import com.android.UIAutomator.core.UiObjectNotFoundException; 
import com.android.UIAutomator.core.UiSelector; 
import com.android.UIAutomator.testrunner.UIAutomatorTestCase; 
public class HelloBugbenTestBase extends UIAutomatorTestCase { 
public HelloBugbenTestBase() ( 
super(); 
// TODO Auto-generated constructor stub 
) 
String bugben txtl - "xiaojianjie"; 
String bugben txt2 = "bugben"; 
String storePath = "/data/local/tmp/displayCheck.png"; 
String testCmp - "com.xuben.hellobugben/.ChangeActivity"; 
GOverride 
public void setUp() throws Exception{ 
super.setUp(); 
// xuben: 启动 ChangeActivity 
startApp (testCmp) ; 
} 
// xuben: 启动 应 用 
private int startApp (String componentName) { 
StringBufer sBufer - new StringBufer(); 
sBufer.append("am start -n "); 
sBufer.append (componentName) ; 
int ret - -1; 
try ( 
Process process = Runtime.getRuntime () .exec (sBufer.toString()); 
ret = process.waitFor(); 
} catch (Exception e) { 
e.printStackTrace(); 
) 
return ret; 
} 
@Override 
public void tearDown() throws Exception{ 
super. tearDown () ; 
} 
// xuben: 提交 文字 测试 
public void testSubmitText() throws UiObjectNotFoundException { 
// xuben: 通过 log 表 示 运 行 的 是 哪 一 个 自动 化 用 例 
Log.v("testChangeTextAndColor", "test change the textview's txt and color by 
UIAutomator"); 
// xuben: 捕获 文本 框 1 并 赋值 
UiObject bugben etl = new UiObject (new UiSelector() .text ("Bugben 微 信 : 巴 哥 奔 ") ) 7 
bbs (bugben etl.exists Q0 && bugben etl.isEnabled()) 
{ 


bugben etl.click(); 
bugben etl.setText (bugben_txt1); 


else ( 
Log.e("txtl Error", "can not found bugben etl"); 


} 
// xuben: 捕获 文本 框 2 并 赋值 
UiObject bugben et2 = new UiObject (new 
UiSelector().text ("BugbenQO:1971629467")) ; 
if(bugben et2.exists() && bugben et2.isEnabled()) 
{ 


bugben_et2.click(); 
bugben et2.setText (bugben txt2); 


else ( 
Log.e("txt2 Error", "can not found bugben et2"); 
} 
// xuben: 捕获 加 粗 选项 框 并 选择 
UiObject bugben bold = new UiObject (new UiSelector() .text (" 加 粗 ") ) 7 
if(bugben bold.exists() && bugben bold.isEnabled()) 


bugben bold.click(); 
} 
else { 
Log.e("bugben bold Error", "can not found 加 粗 ") 7 


} 
// xuben: 捕获 大 号 选项 框 并 选择 
UiObject bugben big = new UiObject (new UiSelector() .text ("大 号 ")); 
if(bugben big.exists() && bugben big.isEnabled()) 
{ 
bugben_big.click(); 


else { 
Log.e("bugben big Error", "can not found X"); 
} 
// xuben: 捕获 提交 按钮 并 按 下 等 待 跳 转 
UiObject subbutton = new UiObject (new UiSelector () .text (" 提 交 ") ) 7 
if(subbutton.exists() && subbutton.isEnabled()) 


subbutton.clickAndWaitForNewWindow () ; 
} 
else { 
Log.e("subbutton Error", "can not found subbutton") ; 


} 

// xuben: 文本 框 1 文本 

UiObject bugben_tvl = new UiObject (new UiSelector () 
-className ("android.widget.LinearLayout") 
.index (0) 
.childSelector (new UiSelector() 
.ClassName ("android.widget.FrameLayout") 
.index(1)) 
.childSelector (new UiSelector () 
-className ("android.widget.TextView") 
.instance(0))); 

// xuben: 文本 框 2 文本 

UiObject bugben tv2 = new UiObject (new UiSelector () 
.className ("android.widget.LinearLayout") 
.index (0) 
.childSelector (new UiSelector() 
.className ("android.widget.FrameLayout") 
.index(1)) 
-childSelector (new UiSelector () 
-className ("android.widget.TextView") 
.instance(1))); 

// xuben: 验证 文本 框 1 的 文本 

if(bugben tvl.exists() && bugben tvl.isEnabled()) 


assertEquals (bugben txtl, bugben tvl.getText().toString()); 


} 
else { 


Log.e("bugben tv1 Error", "can not found bugben tv1"); 


l 
// xuben: 验证 文本 框 2 的 文本 

if(bugben tv2.exists() && bugben tv2.isEnabled()) 

{ 

assertEquals (bugben txt2, bugben_tv2.getText () .toString()); 

} 

else { 

Log.e("bugben tv2 Error", "can not found bugben tv2"); 


} 

// xuben: 截图 对 照 验证 字体 和 字号 

// 注 意 : 这 里 传 入 的 是 "路 径 + 文件 "(File 类 型 ) ， 而 不 单单 是 Path 路 径 

File displayPicFile = new File(storePath) ; 

Boolean displayCap = UiDevice.getInstance() .takeScreenshot (displayPicFile) ; 
assertTrue (displayCap) ; 





Qi 在 实际 项 目 中 ， 文 本 的 变化 有 时 会 非常 大 (尤其 是 用 户 对 界面 要 求 越 来 越 高 ， 界 面 需要 不 断 迭 代 的 情况 下 ， 文 字 更 是 一 日 一 新 ) ， 此 时 ， 如 果 单纯 依靠 控件 文本 进行 控件 捕获 显然 会 陷入 被 
动 。 


而 控件 索引 (index) 或 坐标 点 Guy) 则 更 加 不 靠 谱 (因为 整个 界面 架构 以 及 某 个 控件 的 坐标 变化 更 日 新 月 异 ) 。 











此 时 ， 如 果 能 说 服 研发 人 员 添 加 控件 描述 ( 即 content-desc) 将 大 大 提高 自动 化 脚本 的 稳定 性 。 
2°, 完 有 问题 没 ? 


s» 
SAA, MITRI? 我 迫不及待 地 想 看 结果 ! ! ! 








5.7 更 便捷 地 编译 运行 





UIAutomator 还 有 一 个 麻烦 之 处 : 没 法 通过 Eclipse 直接 编译 。 


Ss 
Tor? 那 怎么 办 ? 


UIAutomator 需 要 经 历 一 系列 的 命令 进行 编译 。 

















参见 http://developer.android.com/tools/testing/testing_ui.html， 具 体 步骤 如 下 。 








1) 通过 如 下 命令 创建 编译 文件 build.xml。 





<android-sdk>/tools/android create uitest-project -n «name» -t 1 -p «path» 





参数 <name> 为 UIAutomator 测 试 工程 名 (如 这 里 的 HelloBugbenTest) ， 而 参数 <path> 为 对 应 的 项 目 路 径 。 


这 里 针对 我 们 的 项 目 ， 命 令 如 下 。 





android create uitest-project -n HelloBugbenTest -t 1 -p "D:\xuben\workspace\HelloBugbenTest" 





Qi <path> 为 待 编译 项 目的 工程 根 目 录 ， 不 要 以 为 是 jar 包 输出 目录 而 任意 指定 〈 巴 哥 奔 之 前 就 指定 到 工程 的 bin 目 录 下 ， 导 致 编译 始终 报错 ) o 


创建 完成 后 ， 刷 新 Eclipse 上 的 测试 项 目 HelloBugbenTest， 如 图 5-23 所 示 。 





- ey la 


: S5 gen [Generated Java Files 
BA Android 4.2.2 
+), Referenced Libraries 
— assets 
3-2» bin 
i -E> res 
oa] AndroidManifest.xml 
-中 build.xml 
[X] lint. xml 
-B local.properties 
5e aiamaja txt 

















project name-"HelloBugbenTest" default-"help" 


«!-- The local.properties file is created and updated by the 'android' tool. 


It contains the path to the SDK. It should *NOT* be checked into 
Version Control Systems. --» 


nz jaar 





图 5-24 build.xml 


2) 将 SDK 路 径 设置 为 ANDROID_HOME， 对 应 Windows 下 命令 如 下 。 





set ANDROID HOME-«path to your sdk> 





而 UNIX 下 命令 为 : 





export ANDROID HOME-«path to your sdk» 





我 们 这 个 项 目 在 Windows 下 对 应 命令 如 下 。 





set ANDROID HOME="D:\xuben\android-sdk-windows4.2" 





3) 进入 编译 文件 (build.xml) 所 在 路 径 并 通过 如 下 命令 编译 项 目 。 


ant build 





Os 如 果 待 编译 项 目 中 包含 中 文 (尤其 是 注释 部 分 ) ， 请 注意 转 码 为 UTF8， 否 则 会 报错 (右键 点 击 项 目 ， 选 择 properties， 在 Resource 下 将 Text file encoding 选 择 为 Other， 选 择 UTF8 即 可 。 若 没 通 
过 Eclipse 打 开 ， 可 借助 Notepad++ 等 文本 处 理工 具 将 格式 转换 为 “以 UTF-8 无 BOM 格 式 编码 ” 即 可 ) o 














编译 完成 后 再 次 刷新 项 目 ， 你 将 看 到 HelloBugbenTest,jar 包 已 生成 在 bin 文 件 夹 下 ， 如 图 5-25 所 示 。 





J-L HelloBugbenTest 

B src 

Ec gen [Generated Java Files 
H-A Android 4.2.2 

(+), Referenced Libraries 


Oe Bee See Pee Ee ee 


(0| pres 
BS sre 
: : AA findrnidManifeact ral 











Dopo a moram eae conn 
(01 he] build. xml 

= |) dasses.dex 

fe classes.dex.d 

| | | 二 HelloBugbenTeSst,jar 
: 7B] local.properties 

| |!  '*—|B] project.properties 

| ERES res 














5-25 HelloBugbenTest.jar-f AR A 





4) 将 生成 的 jar 包 推送 到 手机 端 。 


adb push «path to output jar» /data/local/tmp/ 


相应 地 ， 针 对 本 项 目的 命令 如 下 。 


REM 将 测试 文件 推送 到 手机 
adb push "D:\xuben\workspace\HelloBugbenTest\bin\HelloBugbenTest.jar" /data/local/tmp/ 








5) 在 手机 端 运 行 自动 化 脚本 (BUARE) 中 的 测试 用 例 ， 命 令 如 下 。 

















adb shell UIAutomator runtest LaunchSettings.jar -c com.uia.example.my.LaunchSettings 


Qi 运行 时 必须 指定 到 具体 测试 类 名 而 不 是 项 目 名 ， 本 项 目 名 为 HelloBugbenTest， 包 名 为 com.xuben.hellobugben.test， 如 果 直 接 写 成 “adb shell uiautomator runtest HelloBugbenTest.jar-c 


com.xuben.hellobugben.test.HelloBugbenTest” 则 运行 报错 ， 如 图 5-26 所 示 。 


D: \xuben too ls workNCTS workspace WelloBugbenTest»>adb shell uiautomator runtest 
elloBugbenTest.jar -c com.xuben .hellobugben .test.HelloBugbenTest 


INSTRUMENTATION_RESULT: shortMsg=java.lang.RuntimeException 
INSTRUMENTATION_RESULT: longMsg-com.xuben.hellobugben.test.HelloBugbenTest 
INSTRUMENTATION CODE: 8 





H5-6 ”运行 报错 











应 改 为 具体 测试 类 名 ， 此 处 为 HelloBugbenTestBase， 故 针对 本 项 目的 命令 应 写 为 : 

















adb shell UIAutomator runtest HelloBugbenTest.jar -c 
com.xuben.hellobugben.test.HelloBugbenTestBase 





运行 结果 ， 如 图 5-27 所 示 。 











D: \xuben\tools workspace \He lloBugbenTest>adb shell uiautomator runtest HelloBugh 
enTest.jar -c com.xuben.hellobugben.test .HelloBugbenTestBase 
INSTRUMENTATION_STATUS: numtests=1 

INSTRUMENTATION_STATUS: stream- 
com.xuben.hellobugben.test .He LloBugbenTest Base: 

INSTRUMENTATION_STATUS: id=UifutomatorTest Runner 

INSTRUMENTATION_STATUS: test=testSubmitText 

INSTRUMENTATION_STATUS: class=com.xuben .HelloBugbenTestBase 
INSTRUMENTATION_STATUS: current =1 

INSTRUMENTATION_STATUS_CODE: 1 

INSTRUMENTATION_STATUS: numtests=1 

INSTRUMENTATION_STATUS: stream=. 

INSTRUMENTATION_STATUS: id=UifutomatorTestRunner 

INSTRUMENTATION_STATUS: test=testSubmitText 

INSTRUMENTATION_STATUS: class=com.xuben.hellobughben.test .HelloBughbenTestBase 
INSTRUMENTATION_STATUS: current=1 

INSTRUMENTATION_STATUS_CODE: @ 

INSTRUMENTATION_STATUS: stream= 

Test results for WatcherResultPrinter=. 

Time: 14.266 


OK <i test? 


INSTRUMENTATION_STATUS_CODE: -1 
图 5-27 运行 成 功 
运行 成 功 ! 
6) 运行 完成 后 ， 由 于 本 项 目 有 截图 ， 很 多 人 还 是 习惯 在 PC 端 去 看 截图 ， 所 以 巴 哥 奔 这 里 提供 一 条 返回 截图 的 命令 ， 如 下 。 
adb pull /data/local/tmp/displayCheck.png "D:\xuben\tools\workspace\HelloBugbenTest" 


打开 屏幕 截图 ， 如 图 5-28 所 示 。 


AREKE: ERF 





xlaojlanjie 





图 5-28 屏幕 截图 


译 虽 说 不 上 麻烦 ， 但 缺少 对 应 工具 ， 如 果 反 复 修 改 和 编译 还 是 比较 麻烦 啊 ! 


86, 就 写 个 批 处 理 进行 自动 编译 吧 ! 


如 果 你 觉得 调试 时 反复 修改 和 编译 比较 麻烦 ， 可 以 参考 巴 哥 奔 的 方式 写 个 批 处 理 文件 BuildAndRunUIAutomator.bat， 如 代码 清单 5-23 所 示 。 


中 清 单 5-23 ”自动 化 运行 批 处 理 文件 


REM 进入 Androiqd SDK4.2 的 tools 
cd /d "D:\xuben\android-sdk-windows4.2\tools" 
REM 创建 编译 文件 build.xml 
android create uitest-project -n HelloBugbenTest -t 1 -p "D:\xuben\workspace\HelloBugbenTest" 
REM 将 SDK 路 径 设置 为 ANDROID HOME 
OID HOME \xuben\android-sdk-windows4.2" 
REM 进入 测试 项 目 目录 
cd /d "D:\xuben\workspace\HelloBugbenTest" 
REM 编译 测试 项 目 
ant build 
REM 将 测试 文件 推送 到 手机 
adb h "D: \xuben\workspace\HelloBugbenTest \bin\HelloBugbenTest.jar" /data/local/tmp/ 
REM 运行 自动 化 脚本 
adb shell UIAutomator runtest HelloBugbenTest.jar -c com.xuben.hellobugben.test.HelloBugbenTestBase 
REM 将 截屏 验证 文件 从 手机 端 拷贝 到 PC 
adb pull /data/local/tmp/displayCheck.png "D:\xuben\tools\workspace\HelloBugbenTest" 


事实 上 ， 当 你 运行 过 1 次 后 ， 反 复 修 改 脚本 并 编译 运行 只 需 反 复 执行 如 下 脚本 即 可 ， 如 代码 清单 5-24 所 示 。 


代码 清单 5-24 ”反复 运行 批 处 理 文件 





REM 编译 测试 项 目 

ant build 

REM 将 测试 文件 推送 到 手机 

adb push "D:\xuben\workspace\HelloBugbenTest\bin\HelloBugbenTest.jar" /data/local/tmp/ 

REM 运行 自动 化 脚本 

adb shell UIAutomator runtest HelloBugbenTest.jar -c com.xuben.hellobugben.test.HelloBugbenTestBase 
REM 将 截屏 验证 文件 从 手机 端 措 贝 到 PC 

adb pull /data/local/tmp/displayCheck.png "D:\xuben\tools\workspace\HelloBugbenTest" 





LÀ 
人 除了 -< 参数 外 ， 编 译 命令 还 支持 哪些 参数 ? 


B6, 到 点 子 上 了 ，UIAutomator 更 详细 的 编译 运行 命令 还 有 很 多 。 


UIAutomator 更 详细 的 编译 运行 命令 帮助 ， 如 图 5-29 所 示 。 





Usage: uiautomator <subcommand> [options] 
Available subcommands: 
help: displays help message 


runtest: executes UI automation tests 
runtest <class spec> [options] 
«class spec»: «JARS» < -c «CLASSES» | -e class «CLASSES» > 
«JARS»: a list of jar files containing test classes and dependencies. If 
the path is relative, it's assumed to be under /data/local/tmp. Use 
absolute path if the file is elsewhere. Multiple files can be 
specified, separated by space. 
«CLASSES»: a list of test class names to run, separated by comma. To 
a single method, use TestClass#testMethod format. The -e or -c option 
may be repeated. This option is not required and if not provided then 
all the tests in provided jars will be run automatically. 
options: 
--nohup: trap SIG HUP, so test won't terminate even if parent process 
is terminated, e.g. USB is disconnected. 
-e debug [true|false]: wait for debugger to connect before starting. 
-e runner [CLASS]: use specified test runner class instead. If 
unspecified, framework default runner will be used. 
-e «NAME» «VALUE»: other name-value pairs to be passed to test classes. 
May be repeated. 
-e outputFormat simple | -s: enabled less verbose JUnit style output. 


dump: creates an XML dump of current UI hierarchy 
dump [--verbose] [file] 
[--compressed]: dumps compressed layout information. 
[file]: the location where the dumped XML should be stored, default is 
/storage/sdcard0/window dump.xml 





events: prints out accessibility events until terminated 











5-29 ”编译 运行 命令 帮助 





LÀ 
人 《看 不 太 懂 ， 奔 哥 还 是 解释 解释 吧 ! 


Os, 要 学 会 将 标准 化 文档 转换 为 自己 能 清晰 理解 和 随时 查阅 的 方式 。 


UIAutomator 编 译 运 行 命令 分 类 解释 ， 如 图 5-30 所 示 。 





默认 执行 所 有 测试 类 
通过 $class/$method 指 定 


«c <CLASSES> = 测试 该 class 的 某 一 具体 的 方法 


debug ”进入 debug 模 式 


runtest < 
| runner ”指定 test runner 


le o 
通过 键 值 对 指定 
«NAME» «VALUE» ”传递 给 测试 类 的 参数 


o 以 极 简 格式 输出 








| dump © 以 XML 格 式 输出 当前 UI 树 状 菜单 





一 一 。e events © 事件 打印 


图 5-30 ”UIAutomator 编 译 运行 命令 分 类 解释 


5.8 UlAutomator T Ed 


AC 

66, ua, 听 说 随 着 测试 门槛 大 大 降低 ， 自 动 化 脚本 开发 效率 大 大 提升 了 ! 

人 哈哈， 而且 咱们 的 脚本 还 可 以 跨 应 用 哦 ! 

Fc 

e... 那 帮 程序 员 们 听 说 咱们 可 以 不 用 源码 也 能 开发 出 高 质量 的 自动 化 脚本 ， 简 直 惊 采 了 ! 


P 
人 XDuang 的 一 下 ， 小 伙伴 们 都 惊 呆 了 1! 


UIAutomator 优 势 如 图 5-31 所 示 。 





ht STs 


层级 列表 


一 (2) ImageButton { 三 } [357,484][532,564] 

E (1) TableRow [8,564][532,644] 

| | ©) ImageButton { 四 } [8,564][182,644] 

一 (1) ImageButton {五 } [182,564][357,644] 

一 (2) ImageButton {六 } [357,564][532,644] 

E (2) TableRow [8,644][532,724] 

|. | (O) ImageButton {ts} [8,644][182,724] 

| ~ (1) ImageButton (A) [182,644][357,724] | 
i! 


(3) TableRow [8,724][532,804] 

- (0) ImageButton { 星 形 符号 } [8,724][182, 

- (1) ImageButton {3%} [182,724][357,804] 

一 (2z) ImageButton {英镑 符号 } [357,724][53: | 











图 5-31 UIAutomator 优 势 
不 过 我 发 现 你 们 测试 时 输入 的 是 英文 ， 为 什么 不 用 中 文 进行 测试 ? 
e 人 额 ， 老 板 眼睛 真 毒 ! 这 是 UIAutomator 另 一 个 缺憾 : 目前 还 不 能 为 文本 框 赋值 中 文字 符 。 
89, un: 
go, cs 通过 打开 并 操作 输入 法 ， 模 拟 手 工 输入 中 文字 符 。 
Fc 
Os 
2 PP 这 样 一 来 ， 自 动 化 用 例 的 稳定 性 和 移植 性 将 大 大 降低 〈( 过 于 依赖 某 一 输入 法 应 用 的 某 一 版 本 ， 增 加 很 多 不 可 控 因素 ) o 
说 到 底 ， 就 是 不 建议 通过 中 文 进行 测试 鹃 ! 还 有 哪些 问题 ? 


和 但 在 实际 项 目 中 ， 文 本 的 变化 有 时 会 非常 大 。 

尤其 是 用 户 对 界面 要 求 越 来 越 高 ， 界 面 需要 在 不 断 过 代 的 情况 下 ， 文 字 更 是 一 日 一 新 。 

此 时 ， 如 果 单纯 依靠 控件 文本 进行 控件 捕获 显然 会 陷入 被 动 。 

OS, enn 引 或 坐标 点 呢 ? 

OO (index) 或 坐标 点 Guy) 则 更 加 不 靠 谱 ， 因 为 整个 界面 架构 以 及 某 个 控件 的 坐标 变化 将 更 日 新 月 异 。 
Roses， 无 解 ? 

RO ugra, 如 果 能 说 服 研发 人 员 添 加 控件 描述 〈 即 content-desc) ， 则 将 大 大 提高 自动 化 脚本 的 稳定 性 。 

| (""—————— 
LoT 

AC y nma, tnim 

B5. ux 更 精细 捕获 控件 的 详细 信息 的 API， 如 字体 粗细 、 颜 色 、 字 号 等 信息 ， 而 咱们 这 个 项 目 恰恰 需要 验证 这 些 信 息 。 


E n, 如 果 只 是 验证 文本 是 否 正确 ， 咱 们 是 完全 可 以 做 到 的 ! 


b a) ImageButton {二 } [182,484][357,564] «| 





简单 


o T ， 这 也 是 松 耦 合 带 来 的 缺憾 吧 ， 所 以 这 里 只 能 通过 截屏 的 方式 进行 半自动 验证 。 
你 俩 别 一 喝 一 和 地 找 借 口 ， 那 为 什么 Instrumentation 没 这 问题 ? 
BO or 以 直接 操纵 控件 ， 所 以 可 直接 通过 getTextSize0 ，getPaint0 等 方法 进行 获取 。 


B on. 我 们 强烈 建议 咱们 将 两 个 框架 结合 起 来 使 用 ， 效 果 更 佳 ! 


Instrumentation 与 UIAutomator 互 补 情 况 如 图 5-32 和 图 5-33 所 示 。 





需要 项 目 源码 无 需 项 目 源 码 


脚本 开发 难度 较 高 
开发 效率 较 低 
不 支持 多 应 用 交互 


脚本 开发 难度 较 低 


开发 效率 较 高 


支持 多 应 用 交互 





图 5-32 UIAutomator 弥 补 Instrumentation 


脚本 稳定 性 较 差 脚本 稳定 性 较 好 


调试 较为 困难 调试 简单 方便 直观 





图 5-33 ”Instrumentation 弥 补 UILAutomator 
mc 
Onan 了 。 对 了 ， 最 近 听 说 可 以 通过 什么 兼容 性 测试 来 统一 测试 手机 的 所 有 功能 ， 这 个 测试 你 们 会 吗 ? 


Be, 没 听 说 过 ， 不 过 相信 和 奔 哥 一 定 知道 ! 


第 6 章 ”兼容 性 测试 框架 CTS 使 用 详解 





ELI 兼容 不 兼容 ， 打 一 针 就 知道 ! 


6.1 CTS 概 述 


69... 兼容 性 测试 需要 用 谷歌 提供 的 什么 CTS 来 测 ， 你 能 搞定 吗 ? 

TOS. HAARASLAM IR? 

eo... ，Android 的 CTS 用 户 手 册 已 经 解释 得 很 清楚 了 ! 

eo... 为 用 户 提供 最 好 的 用 户 体验 : 让 更 多 高 质量 应 用 程序 可 以 顺利 运行 在 此 平台 上 。 
其 次 ， 让 程序 员 能 为 此 平台 写 更 多 高 质量 的 应 用 程序 。 

第 三 ， 可 以 更 好 地 利用 Android 应 用 市 场 。 

95... uus, 兼容 性 测试 是 免费 的 ， 而 且 非 常 容易 操作 。 


s» 


So, NEATH! 那 满 足 兼容 性 测试 要 求 是 不 是 很 复杂 ? 大 概 分 几 步 ? 
eo. 需 三 步 ! 
第 一 步 ， 严 格 遵照 Android 兼 容 性 定义 文档 〈 即 传说 中 的 CDD 文 档 ) 进行 开发 ; 


二 步 ， 通 过 兼容 性 测试 ( 即 传说 中 的 CTS 测 试 ) ; 


3 


第 三 步 ， 向 谷歌 CTS 邮 箱 提交 报告 ( 即 传说 中 的 cts@android.com 邮 箱 ) 。 

er 事实 上 ， 企 业 级 用 户 一 般 不 会 直接 提交 报告 ， 而 是 将 设备 寄 送 给 谷歌 兼容 性 测试 相关 人 员 进 行 验证 ， 这 就 是 传说 中 的 “CTS 送 测 ”。 
Se 

< 全 那 又 该 如 何 运行 CTS 呢 ? 

$9... 谷歌 看 来 很 喜欢 “把 大 象 装 入 冰箱 ， 总 共 分 几 步 ? ”这 个 笑话 。 

第 一 步 ， 下 载 CTS 测 试用 例 集 (把 冰箱 门 打 开 ) ; 

第 二 步 ， 运 行 CTS 测 试用 例 集 (把 大 象 放 进 去 ) ; 

第 三 步 ， 查 看 CTS 运 行 报告 (把 冰箱 门 关 上 ) o 

Guz 具体 CTS 运 行 详 见 后 续 章 节 。 

全 区 额 ， 等 于 没 说 ， 那 CTS 具 体 的 工作 流 (workflow) 又 该 是 什么 ? 

$0... 首先 自然 是 下 载 : 使 用 源码 版 本 中 自 带 的 CTS 正 式 版 或 到 Android 官 网 下 载 CTS; 

接 下 来 是 安装 并 配置 CTS; 

第 三 ， 在 运行 CTS 的 PC 上 连接 至 少 一 台 设备 〈 或 打开 至 少 一 个 模拟 器 ) ; 

第 四 ， 启 动 CTS: 此 时 CTS 测 试 套 (test harness) 将 会 把 测试 计划 推送 到 设备 上 。 

eo, 试 完成 后 ， 可 以 通过 浏览 器 查阅 测试 结果 并 以 此 检验 你 的 代码 是 否 正确 。 

E 

那么，CTS 测 试 套 究 竟 背 着 我 们 做 了 些 什么 呢 ? 

eo. .. 首先 测试 套 将 推送 每 一 个 测试 应 用 程序 (.apk 文 件 ) 到 每 台 设 备 上 ， 通 过 Instrumentation 执 行 测试 程序 并 获取 结果 。 
然后 ， 测 试 套 将 在 测试 完成 后 从 每 台 设 备 中 移 除 测试 应 用 程序 。 

他 % 那 CTS 将 会 测试 哪些 类 型 的 用 例 呢 ? 

,Pg 例如 ， 针 对 单个 类 的 测试 ， 如 对 javautil.HashMap 的 测试 。 
其 次 ， 针 对 多 个 Android API 组 合 的 功能 性 测试 ( 巴 哥 奔 称 之 为 “功能 级 单元 测试 ”) o 


第 三 ， 模 拟 应 用 调用 的 全 功能 测试 ， 针 对 所 有 Android API 及 服务 的 测试 。 





[ Ey 


1) 健壮 性 测试 : 通过 压力 测试 检测 其 健壮 性 。 


2) 性 能 测试 : MRR AAAS KAMAL, Wis AMRF. 


E] 
<% 那 CTS 履 盖 哪 些 领域 呢 ? 


2°, 签名 测试 
2) 平台 API 测 试 

3) Dalv 还 虚拟 机 测试 
4) 平台 数据 模型 测试 


5) 平台 Intents 测 试 





6) 平台 权限 测试 


7) 平台 资源 测试 


CTS 覆 盖 领 域 详细 说 明 如 下 。 

















1) 签名 测试 : 针对 每 个 Android 正 式 版 ， 都 将 附带 一 系列 XML 文档 对 所 有 公共 API 签 名 进行 描述 。CTS 将 检查 这 些 签名 是 否 适 用 于 该 设备 ， 并 保存 其 结果 。 

















2 





平台 API 测 试 : 测试 SDK 中 平台 核心 库 (core libraries) 和 Android 应 用 程序 框架 的 APl 是 否 正确 。 








3) Dalvik 虚 拟 机 测试 : 集中 测试 Dalvik 虚 拟 机 。 











4 




















2 


平台 数据 模型 测试 : 测试 通过 content providers (应 用 程序 数据 交换 标准 API) 暴露 给 程序 员 的 平台 数据 模型 (SDK 中 android.provider 包 ) 中 的 核心 部 分 ， 如 联系 人 、 浏 览 器 和 设置 等 应 用 。 





























5) 平台 Intents 测 试 : 测试 在 SDK 中 定义 的 可 用 平台 Intents 中 的 核心 部 分 。 
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i 


平台 权限 测试 : 测试 在 SDK 中 定义 的 可 用 平台 权限 中 的 核心 部 分 。 























7) 平台 资源 测试 : 测试 在 SDK 中 定义 的 可 用 资源 类 型 中 的 核心 部 分 ， 如 simple values/drawables/nfine-patch/animations/layouts/styles/themes 等 。 


9o 了 解 了 这 些 后 ， 接 下 来 咱们 一 起 来 看 看 CTS 在 运行 前 需要 做 哪些 工作 吧 ! 


6.2. CTS 测试 须知 


eo, 习 CTS， 需 要 先 到 官网 下 载 三 个 武器 。 


1) 第 一 个 武器 是 一 本 名 为 CDD ( 即 Compability Definition Document) 的 武功 秘籍 : 该 书 中 文 名 为 “兼容 性 规范 文档 ”。CTS 所 测试 的 一 切 就 是 为 了 确保 设备 符合 该 规范 。 所 以 ， 我 们 测试 之 前 要 必 
须 对 CDD 中 提出 的 要 求 非常 熟悉 才 行 。 

















2) 第 二 个 武器 是 一 个 名 为 CTS ( 即 Compability Test Suite) AMG: 这 不 用 多 说 ，CTS 测 试 套件 ， 用 于 实际 测试 运行 所 用 。 






























































3) 第 三 个 武器 是 一 个 名 为 CTS Verifier 的 应 用 : 它 将 直接 安装 到 手机 上 ， 主 要 用 于 硬件 及 CTS 测 试 套件 难以 测试 的 一 些 偏 功 能 性 的 接口 测试 ， 比 如 Camera、GPS 和 各 种 Sensor 等 。 

















se 
SS bam eT HU RIE? 








到 http://source.android.com/compatibility/downloads.html#android-42 下 载 最 新 文档 ， 如 图 6-1 所 示 。 











CINDROID Source Devices Accessories Compatibility 


Overnew Android Compatibility Downloads 
CTS Overview 
CTS Introduction 
CTS Development 

Thanks for your interest in Android Compatibility! The links bel ow allow you to access the key documents and 


Compatibility Definition informat 
Document (C00) ~ 


Thanks for your interest in Android Compatibility! The links bel ow allow you to access the key documents and 
information 


— Android 4.2 


Contact Us 


Android 4 2 is the release of the devel opment milestone code-named Jelly Bean- MART. Android 4 2 is the current 
version of Android. Source code for Android 4 2 is found in the 'andeoid-4 2 2.01 branch in the open-source tree 
e Androd4 2 Compattelity Definition Document (CDO) 

e Android 4 2 R4 Compatbility Test Suite (CTS) 

e Android 4 2RS CTS Verifier 


Android 4.1 


Android 4.1.1 is the release of the development milestone code-named Jelly Bean Android 4.1.1 is the current 
version of Android. Source code for Android 4.1.1 is found in the 'android-4 T 1, r1 branch in the open-source 
vee 











图 6-1 CTS 最 新 文档 官网 








全 全 部 下 载 下 来 了 ， 现 在 可 以 开始 了 吗 ? 
eo... 在 测试 之 前 你 还 得 完成 一 大 波 预先 设置 。 
A% 那 在 CTS 开 始 运 行 前 都 需要 做 哪些 预先 设置 呢 ? 


下 面 以 Android 4.2.2 为 例 进行 介绍 。 











1) 需要 运行 Android 4.0 以 上 的 用 户 版 本 ( 非 工程 版 ) 。 








2) 需要 按 如 下 规则 对 设备 进行 设置 。 
+ 在 Manifest 文 件 中 加 入 “debuggable” 标 签 。 
“ 将 设备 设置 为 可 调试 模式 。 
“ 使 系统 检测 到 该 设备 。 


3) 运行 CTS 前 确保 你 的 设备 也 已 经 升级 为 Andorid 4.0 以 上 的 用 户 版 。 








4) 确保 Text 和 Speech 文 件 都 被 安装 到 设备 中 。 可 到 Settings> Speech synthesis» install voice data 中 检查 (此 处 假定 设备 上 装 有 Android Market， 若 未 装 该 应 用 可 通过 adb 进 行 这 两 个 模块 文件 的 安 














5) 确保 设备 包含 外 置 SD 卡 且 该 卡 为 空 。 警 告 : CTS 将 会 修改 /删除 SD 卡 中 的 数据 。 











6) 运行 CTS 前 需要 恢复 出 厂 设置 (Settings>storage>Factory data reset) 。 警 告 : 该 操作 将 删除 设备 中 所 有 用 户 数据 。 














7) 确保 屏 锁 已 被 关闭 (Settings» Security» Screen Lock should be'None') 。 

8) 确保 未 知 资源 已 开启 (settings>Security>Enable Unknown sources) 。 

9) 确保 USB 调 试 选项 已 被 勾 选 (Settings» Developer options» USB debuggfing) . 

10) 确保 屏幕 常 亮 已 被 勾 选 (Settings» Developer options>Stay Awake) 。 

11) 确保 Allow mock locations 已 被 勾 选 (Make sure Settings» Developer options» Allow mock locations) 。 


12) 确保 设备 已 连接 上 可 用 的 Wifi 网 络 (Settings> Wi-fi) 。 





13) 确保 语言 已 切换 为 英文 (Language&lnput>language>English(United States)) 。 








14) 确保 当前 屏幕 为 主页 ( 按 下 主页 键 回 到 主页 ) 。 























15) 当 设 备 在 运行 测试 用 例 时 ， 不 允许 再 作 它 用 。 




















16) 当 CTS 运 行 时 不 允许 按 下 设备 上 任何 按键 。 按 下 按键 或 触 屏 可 能 会 干扰 正常 测试 ， 从 而 导致 用 例 运行 失败 。 

















17) 在 执行 accessibility 测 试 包 前 需 执行 以 下 两 步 。 


+ 安装 CtsDelegatingAccessibilityService 应 用 : 





adb install android-cts/repository/testcases/CtsDelegatingAccessibilityService.apk. 





“ 打开 该 服务 : Settings? Accessibility? Delegating Accessibility Service. 
18) 在 执行 administration 测 试 包 前 需要 执行 以 下 两 步 。 


- 安装 CtsDeviceAdmin 应 用 。 





adb install android-cts/repository/testcases/CtsDeviceAdmin.apk. 





“ 打开 该 服务 : Settings? Security? Device Administrators? Enable; 


19) 在 执行 CTS media 压 力 测试 前 需 将 CTS media 文 件 拷贝 到 设备 中 ， 并 进行 调整 (详情 可 参加 CTS 用 户 使 用 手册 相关 描述 ) 。 


E 


入 我 的 神 呐 ， 看 完 我 都 只 了， 更 别提 配置 了 ! 


8 


哈哈 ， 没 办 法 ， 不 设置 好 将 会 大 大 影响 最 终 的 测试 结果 。 不 过 一 回 生 、 两 回 熟 ， 等 你 熟练 后 就 好 了 。 


3 


SaR, BT, FRET, NIET AH T ve? 


e. 那 就 开启 测试 之 旅 吧 ! 


63 《TS 的 命令 及 运行 


en 试 任务 。 首 先 ， 打 开 USB 调 试 。 


通过 USB 线 将 设备 连接 到 PC， 并 打开 USB 调 试 ， 如 图 6-2 所 示 。 








存储 设备 





媒体 设备 (MTP) [] 


相机 (PTP) 


o 


USB 大 容量 存储 设备 





打开 USB 存储 设备 


USB 调试 





连接 USB 后 启动 调试 模式 Zi 


A ”下 次 不 再 提 根 








1. USB 大 容量 存储 (UMS): 通过 USB 连接 至 您 的 计算 机 后 ,如 
REBEH WIS Android 设备 的 USB 存储 设备 之 间 复 制 文 
件 ,请 点 击 " 打 开 USB 存储 设备 "按钮 。Windows XP RUFA 
统 用 户 扒 荐 使 用 此 功能 ， 

2. 媒体 设备 (MTP): 在 Windows 上 以 类 似 U 盘 的 方式 传输 , 浏 
A xit, Windows 7 FRAPA GAVE., X 及 以 下 系 
RRE Windows MediaPlayer 版 本 10 以 上 ， 其 且 安 装 英 一 才 
可 以 使 用 此 功能 ， 

3. 相机 (PTP): 使 你 能 卿 使 用 相机 软件 传输 照片 ， 多 数 计 算 机 邦 
NU S35 PTP 功能 


图 6-2 ”开启 USB 调 试 模式 





“处 后 ， 进 入 cts-tradefed 文 件 所 在 路 径 。 


输入 如 下 命令 进入 cts-tradefed 文 件 所 在 路 径 : 





# cd ~/Android4.2/cts/android-cts-4.2 rl-linux x86-arm/android-cts/tools. 





$9... nns, 其 中 比较 重要 的 是 运行 某 个 测试 计划 。 


确保 至 少 一 台 设 备 已 连接 ， 在 CTS 命 令 控制 台 下 可 运行 CTS 脚 本 ， 如 运行 cts-tradefed 方 式 为 : 




















运行 后 ， 终 端 显示 如 图 6-3 所 示 。 


/cts-tools/android4.2/android-cts/tools# ./cts-tradefed 
Android CTS 4.2 r4 


12-30 11:19:40 I/: Detected new device MSM8625QSKUD 
cts-tf >J 








图 6-3 ”进入 CTS 运 行 模 式 











全 但 我 不 知道 有 哪些 测试 计划 供 我 选择 啊 ? 


eo, 果 不 清楚 需要 执行 哪个 测试 计划 ， 可 通过 输入 如 下 命令 查看 都 有 哪些 测试 计划 。 





如 果 不 清楚 需要 执行 哪个 测试 计划 ， 可 通过 输入 如 下 命令 查看 所 有 计划 。 





cts-tf > list plans 





更 简洁 的 命令 如 下 。 





cts-tf » lp 





终端 显示 如 图 6-4 所 示 。 





Cts-tf > list plans 
AppSecurity 
CTS-fail 

CIS 

PDK 

VM-TF 


Signature 
CTS-TF 
Java 

fail 
Android 











图 6-4 ”CTS 测试 计划 








全 每 个 测试 计划 分 别 测试 哪些 内 容 呢 ? 


eo. 同 版 本 的 CTS 测 试 计划 大 同 小 异 ， 这 里 选择 一 个 版 本 解释 一 下 。 








不 同 版 本 的 CTS 测 试 计划 不 同 ， 以 android-cts-manual-r6 为 例 (与 上 图 略 有 不 同 ， 请 大 家 根据 实际 需求 进行 选择 ) ， 大 致 可 分 为 7 种 测试 计划 ， 如 下 。 




















1) CTS: 运行 所 有 兼容 性 测试 用 例 (Android 4.2 约 1 万 7 干 条 左右 ) ， 目 前 暂 不 包括 性 能 测试 





Bi. 











N 


Signature: 对 签名 的 所 有 公共 接口 进行 验证 。 











3) Andorid: 对 Android 的 接口 进行 测试 。 











A 


Java: 对 Java 核 心 库 进行 测试 。 


5) VM: 对 Dalvik 虚 拟 机 进行 测试 。 





























6) RefApp: 对 参考 应 用 进行 测试 (未 来 CTS 将 发 布 更 多 相关 用 例 ) 。 


7) Performance: 对 性 能 进行 测试 (未 来 CTS 将 发 布 更 多 相关 用 例 ) 。 





$9,.... 明白 ， 可 查看 帮助 信息 。 


通过 “help” 命 令 查看 帮助 ， 如 下 。 





cts-tf » help 





终端 显示 如 图 6-5 所 示 。 





cts-tf > help 
CTS-tradefed host version 4.2 r4 


CTS-tradefed is the test harness for running the Android Compatibility Suite, built on top of the tradefed framework. 


Available commands and options 
Host: 
help: show this message 
help all: show the complete tradefed help 
exit: gracefully exit the cts console, waiting till all invocations are complete 


cts --plan test_plan_name: run a test plan 

cts --package/-p : run a CTS test package 

cts --class/-c [--method/-m] : run a specific test class and/ormethod 

cts --continue-session session_ID: run all not executed tests from a previous CTS session 

cts [options] --serial/s device ID: run CTS on specified device 

cts [options] --shards number_ofkshards: shard a CTS run into given number of independent chunks, to run on multiple de 
inparallel 

cts --help/--help-all: get more help on running CTS 


d/devices: list connected devices and their state 

packages: list CTS test packages 

p/plans: list CTS test plans 

i/invocations: list invocations aka CTS test runs currentlyin progress 

c/commands: list commands: aka CTS test run commands currently in the queue waiting to be allocated devices 
r/results: list CTS results currently present in the repository 


Dump: 
d/dump l/logs: dump the tradefed logs for all running invocations 
Options: 
--disable-reboot : Do not reboot device after running some amount of tests. 





cts-tf > | 





6-5 CTS 帮助 信息 











So 
从 明 白 了 ， 下 面 咱们 开始 执行 CTS 计 划 吧 


执行 CTS 计 划 。 





cts-tf > run cts --plan CTS 





CTS 测 试 计划 执行 过 程 如 图 6-6 所 示 。 





run cts --plan CTS 
I/0123456789ABCDEF: Collecting device info 
:33:38 I1/0123456789ABCDEF: 

:40 I/0123456789ABCDEF: android.acceleration. .HardwareAccelerationTest£testIsHardwareAccelerated PASS 

:41 I/0123456789ABCDEF: android.acceleration. .HardwareAccelerationTest£testNotAttachedView PASS 

:42 I/0123456789ABCDEF: android.acceleration. .SoftwareAccelerationTest#testIsHardwareAccelerated PASS 

:43 I/0123456789ABCDEF: android.acceleration. .SoftwareAccelerationTest£testNotAttachedView PASS 

:44 I/0123456789ABCDEF: android.acceleration.cts.WindowFlagHardwareAccelerationTest#testIsHardwareAccelerated PASS 


:45 I/0123456789ABCDEF: android.acceleration.cts.WindowFlagHardwareAccelerationTest#testNotAttachedView PASS 

:48 I/0123456789ABCDEF: android.acceleration package complete: Passed 6, Failed 0, Not Executed 0 

:48 1/0123456789ABCDEF : 

:48 I/0123456789ABCDEF : 

:48 I1/0123456789ABCDEF: 

:33:56 I/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityEndToEndTest#testTypeNotificationStateChange 

AccessibilityEvent PASS 
2-30 11:33:57 I/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityEndToEndTest#testTypeViewClickedAccessibilit 


: android.accessibilityservice.cts.AccessibilityEndToEndTest#testTypeViewFocusedAccessibilit 
: android.accessibilityservice.cts.AccessibilityEndToEndTest#testTypeViewLongClickedAccessib 


2-30 11:34:00 I/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityEndToEndTest#testTypeViewSelectedAccessibili 
tyEvent PASS 
2-30 11:34:01 I/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityEndToEndTest#testTypeViewTextChangedAccessib 
ilityEvent PASS 
2-30 11:34:02 I/0123456789ABCDEF: android.accessibilityservikkce.cts.AccessibilityEndToEndTest#testTypeWindowStateChangedAcces 
SibilityEvent PASS 
2-30 11:34:03 I/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityFocusAndInputFocusSyncTest#testActionAccessi 
bilityFocus PASS 
2-30 11:34:04 I/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityFocusAndInputFocusSyncTest#testActionClearAc 
essibilityFocus PASS 
12-30 11:34:05 I/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityFocusAndInputFocusSyncTest#testFindAccessibi 
ityFocus PASS 
12-30 11:34:06 I/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityFocusAndInputFocusSyncTest£testInitialStateN 
oAccessibilityFocus PASS 
2-30 11:34:17 I/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityFocusAndInputFocusSyncTest#test0OnlyOneNodeHa 
sAccessibilityFocus PASS 
2-30 11:34:17 I/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityServiceInfoTest£testAccessibilityServiceInfo 
lForEnabledService PASS 

:17 I/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityServiceInfoTest#testAndroidTestCaseSetupProp 


:17 1/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityServiceInfoTest#testDescribeContents PASS 
:17 I/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityServiceInfoTest#testFeedbackTypeToString PAS 


:17 1/0123456789ABCDEF: android.accessibilityservice.cts.AccessibilityServiceInfoTest#testFlagTfoString PASS 
:17 I/O123456789ABCDEF: android.accessibilityservice.cts.AccessibilityServiccInfoTost#tcstMenrgbhalli ony DASS. 


图 6-6 ”CTS 测试 执行 
a 测 菜 个 包 ， 可 以 吗 ? 
办 ， 我 们 先 看 看 都 有 哪些 包 。 
如 果 希 望 执行 某 个 测试 包 ， 可 通过 输入 如 下 命令 查看 某 一 包 内 容 。 
cts-tf > list packages 
更 简洁 的 命令 如 下 。 
cts-tf > 1 packages 


终端 显示 如 图 6-7 所 示 。 


.acceleration 
„accessibility 
.accessibilityservice 
.accounts 

admin 
.animation 


app 
.bluetooth 


.Calendarcommon 





Libcore.package. 

. tests. libcore.package. 
.tests.libcore.package. 
.tests.libcore.package. 
. tests. libcore.package. 
. tests. libcore.package. 
vm-tests-tf 

.database 

.dpi 

. dpi2 

.drm 

,effect 

.example 

.gesture 

.graphics 

.graphics2 

. hardware 

.holo 

.jni 

. Location 

.media 

.mediastress 

.monkey 

.nativemedia.sl 

.nativemedia.xa 

.ndef 

.net 

. opengl 

.openglperf 

.05 

.permission 


$5 
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执行 某 个 测试 包 。 





cts-tf » run cts --package «package name» 





如 测试 util 包 ， 如 下 。 





cts-tf > run cts --package android.util 





终端 显示 如 图 6-8 所 示 。 





cts-tf > run cts --package android.util 


cts-tf > J 





图 6-8 执行 某 个 测试 包 


eo, ix 想 单独 测试 某 个 用 例 ， 可 以 做 到 吗 ? 





e; 
SRA, ASPARACALT! 








单独 测试 某 个 用 例 命令 如 下 。 




















cts-tf > run cts --class «class name» --method «testcase name» 





更 简洁 的 命令 如 下 。 





cts-tf > run cts -c «package name» -m «testcase name» 











例如 ， 这 里 我 们 想 单 独 执行 “testlsHardwareAccelerated” 这 个 测试 用 例 ， 如 下 。 











cts-tf > run cts -c android.acceleration.cts.HardwareAccelerationTest -m testIsHardwareAccelerated 





终端 显示 如 图 6-9 所 示 。 





cts-tf > run cts -c android.acceleration.cts.HardwareAccelerationTest -m testIsHardwareAccelerated 

12-30 14:17:35 I/0123456789ABCDEF: Collecting device info 

12-30 14:17:36 I/0123456789ABCDEF : 

12-30 14:17:36 I/0123456789ABCDEF: 

12-30 14:17:36 I/0123456789ABCDEF : 

12-30 14:17:38 I/0123456789ABCDEF: android.acceleration.cts.HardwareAccelerationTest#testIsHardwareAccelerated PASS 

12-30 14:17:42 I/0123456789ABCDEF: Saved log device logcat_6918928089258816886. zip 

12-30 14:17:42 I/0123456789ABCDEF: Saved log host log 8086502034032650084. zip 

12-30 14:17:42 I/0123456789ABCDEF: android.acceleration package complete: Passed 1, Failed 0, Not Executed 0 

12-30 14:17:42 I/0123456789ABCDEF: Created xml report file at file:///root/cts-tools/android4.2/android-cts/tools/./../../and 
roid-cts/repository/results/2013.12.30 14.17.13/testResult.xml 

12-30 14:17:42 I/0123456789ABCDEF: XML test result file generated at 2013.12.30 14.17.13. Passed 1, Failed 0, Not Executed 0 
12-30 14:17:42 I/0123456789ABCDEF: Time: 28s 

12-30 14:17:42 I/TestInvocation: Starting invocation for ‘cts' on build ‘4.2 r4' on device 0123456789ABCDEF 

12-30 14:17:42 W/CtsTest: No tests to run 

12-30 14:17:58 I/0123456789ABCDEF: Collecting device info 

12-30 14:17:58 E/DeviceInfoResult: Inconsistent info collected from devices. Current result has build device='kitonw', Receiv 
ed 'A3000'. Are you sharding or resuming a test run across different devices and/or builds? 

12-30 14:17:58 E/DeviceInfoResult: Inconsistent info collected from devices. Current result has build_fingerprint='Lenovo/kit 
onw/kitonw:4.2.2/JDQ39/K910 w SS S 2 040 0108 131225:user/releasekey', Received 'Lenovo/LenovoA3000-H/A3000:4.2.2/JD039/A3000 
_A422_009 020 131112 WW _C:user/release-keys'. Are you sharding or resuming a test run across different devices and/or builds? 
12-30 14:17:58 E/DeviceInfoResult: Inconsistent info collected from devices. Current result has build board='MSM8974', Receiv 
ed 'a3000 row call'. Are you sharding or resuming a test run akross different devices and/or builds? 

12-30 14:17:58 E/DeviceInfoResult: Inconsistent info collected from devices. Current result has buildName='kitonw', Received 
'LenovoA3000-H'. Are you sharding or resuming a test run across different devices and/or builds? 

12-30 14:17:58 E/DeviceInfoResult: Inconsistent info collected from devices. Current result has build model='Lenovo K910', Re 
ceived ‘Lenovo A3000-H'. Are you sharding or resuming a test run across different devices and/or builds? 

12-30 14:17:58 E/DeviceInfoResult: Inconsistent info collected from devices. Current result has screen_size='normal', Receive 
d 'large'. Are you sharding or resuming a test run across different devices and/or builds? 





图 6-9 执行 某 个 测试 用 例 
| T" 
Se 
全 好 的 ， 稍 等 片刻 ! 


通过 “list results” 查 看 测试 结果 ， 如 下 。 





cts-tf > list results 





更 简洁 的 命令 如 下 。 





cts-tf > lr 





终端 显示 如 图 6-10 所 示 。 





cts-tf » lr 
Session Pass Not Executed Start time Plan name Device serial(s) 
17950 2013.09.17 18.20. CTS P75HZHSS55IVB6MF 
15 2013.09.18 10.07. CTS-fail P75HZHSS55IVB6MF 
2889 15066 2013.09.18 12.33. CTS P75HZHSS55IVB6MF 
17937 2013.09.18 19.03. CTS P75HZHSS55IVB6MF 
35 2013.09.19 12.50. NA P75HZHSS55IVB6MF 
23 2013.09.19 13.13. NA P75HZHSS55IVB6MF 
44 2013.09.19 13.34. NA P75HZHSS55IVB6MF 
2013.09.19 13.48. P75HZHSS55IVB6MF 
2013.09.19 13.49. P75HZHSS55IVB6MF 
2013.09.19 13.51. P75HZHSS55IVB6MF 
2013.09.19 13.52. P75HZHSS55IVB6MF 
2013.09.19 13.53. P75HZHSS55IVB6MF 
2013.09.19 14.08. i P75HZHSS55IVB6MF 
2013.09.19 15.25. unknown 
2013.09.19 15.34. DMLFWCSSTGS47SI17 
2013.09.22 09.36. | i unknown 
2013.09.22 09.44. CTS-fail DMLFWCSSTGS47SI7 
2013.09.23 18.41. CTS EIPRK7NNJNYLNZRO 
2013.09.24 10.30. CTS-fail EIPRK7NNJNYLNZRO 
2013.09.25 17.35. CTS JR45U4GQA6KZ95GQ 
2013.09.26 09.43. CTS-fail JR45U4GQA6KZ95GQ 
2013.09.26 18.02. CTS P7Q88LV8US65FI0B 
2013.09.27 09.59. CTS-fail P7Q88LV8US65FI0B 
2013.09.29 15.55. CTS CYHQKVLNL7VCEISO 
2013.09.30 09.37. CTS-fail CYHQKVLNL7VCEISO 
2013.09.30 09.41. CTS-fail CYHQKVLNL7VCEISO 
2013.10.06 12.53. CTS JR45U4GQA6KZ95GQ 
2013.10.06 17.49. CTS 65HMAAMVV48LAYNN 
2013.10.07 11.49. CTS-fail JR45U4GQA6KZ95GQ 
2013.10.07 13.25. CTS-fail 65HMAAMVV48LAYNN 
2013.10.07 14.28. CTS P75HZHSS55IVB6MF 
2013.10.08 09.53. CTS-fail P75HZHSS55IVB6MF 
2013.10.08 10.00. CTS-fail P75HZHSS55IVB6MF 
2013.10.11 10.38. CTS RWGC6PRMFCYNZDE07 
2013.10.11 15.39. CTS- fail RWG6PRMFCYNZDEO7 
2013.10.11 16.00. CTS-fail RWG6PRMFCYNZDEO7 
2013.10.11 16.34. CTS 7PINSDIFJR89AUGQ 
2013.10.12 09.54. CTS-fail 7PINSDIFJR89AUGQ 
2013.10.22 11.22. JR45U4GQA6KZ95GQ 
2013.10.22 11.25. JR45U4GQA6KZ95GQ 
2013.10.22 11.26. JR45U4GQA6KZ95GQ 
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图 6-10 CTS 测试 结果 


哈哈 ， 一 清二 楚 ， 一 目 了 然 ! 


Reses 
AJ VL D. E 


eo, 测试 完成 后 把 报告 发 到 我 邮箱 里 面 吧 ! 
全 % 哇 ， 今 天 已 经 测试 很 晚 了 ， 能 不 能 明天 再 写 报告 ? 


eo 没事 ，CTS 测 试 报告 是 自动 生成 一 个 xml 格 式 的 报告 并 自动 填写 运行 情况 ， 无 需 手 动 填写 。 





当 一 个 CTS 测 试 任务 开始 时 ， 会 在 “android-cts-4.2/android-ctsrepository/results” 里 面 每 个 任务 对 应 一 个 测试 报告 文件 夹 ， 文 件 名 以 任务 开始 的 日 期 和 时 间 命 名 ， 如 2013.12.30_14.18.24， 如 
6-11 所 示 。 
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vi 
A 
vF 





cts result.css cts result.xsl logo. gif newrule-green.png testResult. xml: 


图 6-11 CTS 测试 报告 














除 此 之 外 ,在 “android-cts-4.2/android-cts/repository/results” 下 你 还 能 找到 一 个 同名 的 压缩 包 ， 如 2013.12.30_14.18.24.zip， 如 图 6-12 所 示 。 


e013,12.30 14,18.24,zip 














"Acts result.css 
cts result. xsl 


™ | newrule-green.png 
= testResult. xml 


图 6-12 CTS 测试 报告 压缩 包 





*e 
区 我 管 它 是 文件 夹 还 是 压缩 包 ， 我 只 关注 测试 报告 ! 




















无 论 是 文件 夹 还 是 压缩 包 ， 我 们 真正 关注 的 其 实 就 是 名 为 testResult.xmI 的 测试 报告 ， 通 过 浏览 器 打开 ， 你 将 看 到 测试 报告 ， 如 图 6-13 所 示 。 


Compatibility program Test Report for Lenovo A3000-H - 0123456789ABCDEF 


Show Device Information 


Test Summary by Package 


Detailed Test Report 





图 6-13 CTS 测试 报告 总 体 显示 
具体 用 例 执行 情况 ， 如 图 6-14 所 示 。 


Compatibility Test Package: android.util 





图 6-14 CTS 测试 报告 具体 用 例 结果 


B orsus 失败 的 测试 项 进行 测试 呢 ? 


Q6, cu; 我 们 可 以 这 样 干 ! 


首先 ， 通 过 如 下 命令 查看 测试 结果 。 





cts-tf > list results 





更 简便 的 命令 如 下 。 





cts-tf » lr 





终端 显示 如 图 6-15 所 示 。 
其 次 ， 根 据 start time 时 间 ， 确 定 你 要 的 任务 的 session 编 号， 如 34。 


然后 ， 即 可 通过 如 下 命令 对 待 测 项 进行 测试 。 





add derivedplan --plan plane name -s session id -r [pass/fail/notExecuted/timeout] 





如 ， 





add derivedplan --plan plane name -s 34 -r fail 





Oo. 1) 一 般 情 况 下 ， 我 们 需要 先 查 看 测试 结果 testResult xml 文 件 后 再 执行 该 测试 。 


2) 在 -+ 后 ，[pass/fail/notExecuted/timeout] 这 几 项 只 能 选择 其 中 一 项 (如 上 所 选 的 fail 项 ) 进行 测试 。 


Fail Not Executed Start time Plan name Device serial(s) 
2013.09.17 18.20. P75HZHSS55IVB6MF 
2013.09.18 10.07. i P75HZHSS55IVB6MF 
5066 2013:097 18912:33; P75HZHSS55IVB6MF 
2013.09.18 19.03. P75HZHSS55IVB6MF 
2013.09.19 12.50. P75HZHSS55IVB6MF 
2013.09.19 13.13. P75HZHSS55IVB6MF 
2013.09.19 13.34. P75HZHSS55IVB6MF 
2013.09.19 13.48. P75HZHSS55IVB6MF 
2013.09.19 13.49. P75HZHSS55IVB6MF 
2013.09.19 13.51. P75HZHSS55IVB6MF 
2013.09.19 13.52. P75HZHSS55IVB6MF 
vip Fx P75HZHSS55IVB6MF 
2013.09.19 14.08. i P75HZHSS55IVB6MF 
2013.09.19 15.25. unknown 
2013.09.19 15.34. DMLFWCSSTGS47SI17 
2013.09.22 09.36. i i unknown 
2013.09.22 09.44. CTS-fail DMLFWCSSTGS47SI17 
2013.09.23 18.41. CTS EIPRK7NNJNYLNZRO 
2013.09.24 10.30. CTS-fail EIPRK7NNJNYLNZRO 
2013.09.25 17.35. CTS JR45U4GQA6KZ95GQ 
2013.09.26 09.43. CTS-fail JR45U4GQA6KZ95GQ 
2013.09.26 18.02. CTS P7Q88LV8US65FIOB 
2013.09.27 09.59. CTS-fail P7Q88LV8US65FIOB 
2013.09.29 15.55. CTS CYHQKVLNL7VCEISO 
2013.09.30 09.37. CTS- fail CYHQKVLNL7VCEISO 
2013.09.30 09.41. CTS-fail CYHQKVLNL7VCEISO 
2013.10.06 12.53. CTS JR45U4GQA6KZ95GQ 
2013.10.06 17.49. CTS 65HMAAMVV48LAYNN 
2013.10.07 11.49. CTS-fail JR45U4GQA6KZ95GQ 
2013:710:07:13:25; CTS-fail 65HMAAMVV48LAYNN 
2013.10.07 14.28. CTS P75HZHSS55IVB6MF 
2013.10.08 09.53. CTS-fail P75HZHSS55IVB6MF 
2013.10.08 10.00. CTS-fail P75HZHSS55IVB6MF 
20131071 1810538; CTS RWG6PRMFCYNZDEO7 
2813:307 118915 :39; CTS-fail RWG6PRMFCYNZDEO7 
2013.10.11 16.00. CTS-fail RWG6PRMFCYNZDEO7 
2013.10.11 16.34. CTS 7PINSDIFJR89AUGQ 
2013.10.12 09.54. CTS-fail 7PINSDIFJR89AUGQ 
2013.10.22 11.22. NA JR45U4GQA6KZ95GQ 
2013.10.22 11.25. NA JR45U4GQA6KZ95GQ 
2013.10.22 11.26. NA JR45U4GQA6KZ95GQ 
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H645 CTS 测试 结果 


最 后 ,执行 该 命令 开始 测试 。 





run cts --plan «plane name» 








测试 完成 后 ，CTS 会 自动 生成 一 个 新 测试 报表 文件 来。 














o. peas CTS 4.2 生 成 测试 报告 的 速度 比 CTS 2.3/2.2 慢 ， 如 果 在 此 过 程 中 按 <Ctd+C> 组 合 键 将 终止 CTS 进 程 ， 测 试 报告 就 无 法 生成 ， 以 后 也 无 法 继续 测试 未 完成 的 计划 。 


D 


人 测试 完成 ! 奔 哥 ， 接 下 来 咱们 该 学 什么 ? 


5 


上 


eo, 就 带 你 简单 看 看 传说 中 的 CTSVerifier 工 具 吧 ! 


首先 ， 安 装 CtsVerifierapk， 如 下 。 


$ adb install CtsVerifier.apk 














Sez, FRH. ib, Wl 


























rz 





到 6-16 和 图 6-17 所 示 。 














Python for Ai CTS Verifier 








iis, CTS Verifier 4.. 


CAMERA 


Camera FOV Calibration 
Camera Formats 
Camera Intents 

Camera Orientation 
DEVICE ADMINISTRATION 


Policy Serialization Test 


ame 


SS = 





FEATURES 


Hardware/Software Feature Summary 


HARDWARE 
GPS Test 


USB Accessory Test 


图 6-17 CtsVerifier E RG 
都 是 什么 测试 项 啊 ? 


正如 之 前 所 述 ， 主 要 包括 硬件 及 CTS 测 试 套件 难以 测试 的 一 些 偏 功 能 性 的 接口 测试 ， 比 如 Camera、GPS 和 各 种 Sensor 等 。 
下 面 以 相机 定向 测试 (Camera Orientation) 为 例 向 大 家 展示 一 下 这 个 测试 。 
1) 点 击 测试 列表 中 “Camera Orientation” 项 ， 如 图 6-18 所 示 。 
2) 进入 后 ， 该 界面 的 Pass 和 Fail 两 个 选项 均 为 不 可 点 击 状态 ， 避 免 大 家 误 操作 。 
3) 点 击 中 间 的 “info” 按 钮 ， 将 向 你 详细 解释 该 测试 的 目的 、 步 骤 和 判断 标准 ， 如 图 6-19 所 示 。 


4) 左边 显示 相机 预览 界面 ， 右 边 为 “Take Photo” RHA (该 测试 主要 是 测 相机 自动 旋转 功能 ， 所 以 CtsVerifier 将 控制 相机 预览 界面 每 拍摄 一 张 照片 后 旋转 90 度 。 先 拍摄 后 置 摄像 头 的 画面 ， 完 成 后 切 
换 到 前 置 摄像 头 ， 重 复 一 遍 操作 进行 前 置 自 动 旋转 测试 ) ， 如 图 6-20 所 示 。 


5) 每 点 击 一 次 “Take Photo” 按 钮 ， 将 在 预览 界面 旁边 显示 拍摄 后 的 画面 ， 供 测试 者 对 比 预览 和 实际 拍摄 的 画面 是 否 一 致 ， 如 图 6-21 所 示 。 
6) 每 拍摄 完 一 张 照片 ， 该 界面 的 Pass 和 Fail 两 个 选项 将 恢复 为 可 点 击 状态 ， 供 测试 者 确认 该 项 是 否 通过 。 


7) 全 部 测试 完成 后 ， 如 果 全 都 Pass， 则 该 项 显示 为 Pass， 如 图 6-22 所 示 。 


wis, CTS Verifier 4 


CAMERA 


Camera FOV Calibration 





amera Formats 


Camera Intents 


Camera Ornentation 


DEVICE ADMINISTRATION 


Policy Serialization Test 
Screen Lock Test 
FEATURES 


Hardware/Software Feature Summary 


HARDWARE 
GPS Test 


ISB Accessory Test 





5.82K/s 4] © + seni COE) 1 


€ Camera Orientation 


shows the captured image. 

- For each camera and orientation, both the 
left and right views should appear rotated 
clockwise by the amount of degrees 
specified. Choose "Pass" if this is the case. 
Otherwise, choose ‘Fail’. 

- For front-facing cameras, the test will 
horizontally mirror the captured image prior 
to rotation, in attempt to make the left and 


rinht vieawe annear the cama 


确定 





AE. 65K/s 1 名 


wis, Camera Orientation 
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Camera preview Oriented photo 


Info 





Tni CH) 16:28 


amera: 1 of 2 


rientation 1 of 4: 0° 
ockwise 


ake a photo 


Take Photo 


Camera preview 


Oriented p 


Info 





0.0K/s K E F soui OGI 16:31 


OCJ 16:32 


E Camera: 1 of 2 
Orientation 1 of 4: 0° 
clockwise 


EXI--M] 


Instruction: 
Choose "Pass" if the left 
view is oriented the same 
as the right view. 
- Otherwise, choose ‘Fail’. 
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Camera FOV Calibration 
Camera Formats 
Camera Intents 
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Jrientation 


DEVICE ADMINISTRATION 


Policy Serialization Test 


screen Lock Test 

FEATURES 

Hardware/Software Feature Summary 
HARDWARE 


GPS Test 


USB Accessory Test 


图 6-22 ”该 项 所 有 子 项 全 部 pass 
e» 
全 明白 了 ， 还 有 个 问题 : 界面 上 的 “垃圾 桶 ”、“ 眼 晴 ” 和 “软盘 ”这 3 个 图 标 分 别 是 什么 功能 ? 
Sou 圾 桶 ”表示 清空 之 前 测试 结果 。 “眼睛 ”将 显示 当前 布局 的 XML 形式 。 “软盘 ”将 会 存储 咱们 的 测试 结果 。 


点 击 “ 眼 睛 ”图 标 后， 弹出 当前 布局 XML， 如 图 6-23 所 示 。 点 击 “ 垃 圾 桶 ”图 标 后 ， 所 有 测试 结果 将 被 清空 ， 如 图 6-24 所 示 。 


T- 5.94K/s @ s:s6ni CPG) 15:44 


gis, Report Viewer 


<?xml version= de encoding= utf-8 





«test-results-report report-version- 2" 
creation-time= Tue Mar 10 15:44:33 
GMT+08:00 2015"> 
<verifier-info version-name-"4.2. r5" 
version-code='1" /> 
«device-info» 
<build-info board="MSM8974' 
brand= Lenovo’ device='kiton" 
display= kiton-eng 4.4.2 KOT49H 
K910_1_S_3_2144.1_0101_140507 
release-keys' fingerprint="Lenovo/kiton/ 
kiton:4.4.2/KOTA9H/ 
K910. 1. S. 3 2144.1. 0101. 140507:eng/ 
release-keys" id- KOT49H 
model= Lenovo K910" product= kilton 
releasSe= 4.4.2 sdk= 19 /> 
</device-info> 
<test-results> 
<test title="Camera FOV Calibration’ 
class- 
name="com.android.cts.verifier.camera.f 
ov.PhotoCaptureActivity" result="not- 
executed" /> 
<test title="Camera Formats’ class- 





wis, CTS Verifier 4.. 


CAMERA 


Camera FOV Calibration 
Lamera Formats 


Camera Intents 





Report saved to: /storage/ 
emulated/0/ctsVerifierReports/ 


ctsVerifierReport-2015.03.10-15.4 
4.49-LENOVO-kiton-kiton- 
KOT49H.zip 


确定 


FEATURES 
Hardware/Software Feature Summary 
HARDWARE 


GPS Test 





USB Accessory Test 





图 6-24 清空 所 有 测试 结果 


6.6 CTS 注意 事项 


全 部 搞定 了 ! 奔 哥 ， 我 发 现 随 着 执行 次 数 增加 ， 启 动 越 来 越 慢 了 。 

$69, n 为 每 次 执行 时 CTS 会 自动 搜索 历史 报告 文件 ， 如 果 文 件 很 多 ， 启 动 速度 就 会 越 来 越 慢 。 所 以 ， 要 养 成 定期 清理 历史 报告 的 习惯 (或 移动 到 其 他 目录 ) 。 
pA 

<% 有 的 时 候 ， 我 这 边 执行 很 正常 ， 但 别人 执行 总 是 报错 ， 这 是 为 什么 ? 

| NT 建议 先 将 手机 恢复 到 出 厂 设 置 ， 然 后 检测 硬件 和 内 置 应 用 功能 是 否 完好 ， 再 严格 按照 预 置 条 件 进 行 配置 ， 逐 一 排解 问题 。 

CR, SULSLCIS 4.2 的 命令 与 之 前 的 CTS 命 令 出 入 很 大 ， 怎 么 办 ? 

eo... 所 以 建议 大 家 用 CTS 新 版 本 测试 前 都 通过 help 命 令 查看 更 新 后 的 命令 格式 。 

从 奔 可 ， 现 在 最 大 的 问题 是 ， 我 整 天 盯 着 手机 ， 每 天 头晕 眼花 的 ， 而 且 晚上 手机 自动 关机 也 很 烦人 。 

89.4 ons, 只 需 最 后 看 测试 结果 即 可 。 一 轮 测 试 时 间 很 长 ， 晚 上 最 好 插 上 电源 进行 测试 。 

人 人 % 有 时 早上 过 来 手机 也 还 有 电 ， 但 是 就 是 没有 测试 报告 ， 这 是 什么 情况 ? 

dd Qcrs 4.2 在 测试 过 程 中 断 开 、 终 止 都 不 会 生成 测试 报告 ， 所 以 ， 测 试 前 要 保证 USB 连 接 稳 定 。 
| ONERE ET TTE 

-5% 啊 ?一 上 来 就 把 我 问 住 了 ， 不 知道 读 ! 

eo... 需要 通过 CTS 和 CTS_Verifier 测 试 。 

Grex CTS&CTS_Verifieri] iX: Android 的 版 本 必须 和 CTS 版 本 对 应 ， 自 测试 通过 后 ， 将 测试 报告 提交 给 Google 进 行 认证 。 


85,.. 需要 通过 GTS 测 试 。 


oe GTS 测 试 : 属于 CTS 认 证 中 的 一 项 测试 ，GMS build 必 须要 通过 GTS 测 试 ， 自 测试 通过 后 ， 提 交 给 Google 进 行 认 证 。CTS 认 证 abptoved 后 ，Google 会 自动 将 设备 加 入 和 白 名 单 ， 可 以 正常 使 用 
Google Play Store 中 的 服务 ，WideVfine 中 的 key 可 以 对 付费 /视频 的 加 密 文件 解锁 。 目 前 GTS 测 试 工具 版 本 为 1.3.3 (ICS+ 以 上 版 本 需要 测试 ) 。 





第 三 ， 要 满足 对 应 版 本 的 CDD 的 要 求 。 

oe 谷歌 定义 了 一 个 兼容 性 规范 〈Compatibility Definition) ， 而 CTS 就 是 用 于 确保 设备 符合 该 规范 。 所 以 ， 测 试 之 前 要 先 了 解 CDD， 并 且 满足 CDD 中 要 求 。CDD 同 样 必须 对 应 Android 的 版 本 。 
9o... , ilh X Google Partner MADA 协 议 以 及 Google Default Setting Guidelfines o 

Oo. 以 上 条 件 都 满足 Google 要 求 ， 并 且 通 过 Google 测 试 后 ， 提 交 认 证 的 版 本 会 通过 CTS 认 证 ， 此 版 本 可 以 发 布 到 市 场 。 


全 % 呀 ， 要 满足 Google 所 有 要 求 真心 不 容易 呢 ! 


67 CTS 工 具 总 结 


06, 大 家 一 个 好 消息 ， 提 交 给 Google 的 CTS 报 告 一 次 性 通过 了 ! 


wow, KAT! 
这 个 CTS 测 试 除了 应 付 Google 外 ， 还 有 哪些 用 处 呢 ? 
£ 当然 有 了 ! 我 们 要 认 清 CTS 测 试 的 本 质 ， 它 是 基于 应 用 接口 的 单元 测试 ， 而 咱们 之 前 的 测试 都 是 基于 应 用 功能 方面 的 自动 化 测试 。 


你 接口 单元 测试 ? 功能 自动 化 测试 ? 


99, 单 地 说 ， 当 咱们 需要 对 接口 基本 功能 进行 简单 测试 时 ， 可 通过 CTS 框 架 快速 进行 测试 。 当 咱们 需要 对 测试 用 例 进行 自动 化 操作 时 ， 可 通过 其 他 框架 完成 更 复杂 的 操作 。 
fe 
SAB FEL] 83 FRE AR RHP I0 4 a v? 


eo, s. 用 例 操作 可 以 调用 接口 ， 如 Instrumentation， 也 可 通过 坐标 点 ， 如 monkey 父 子 ， 还 可 通过 文本 、 描 述 、 索 引 等 ， 如 UIAutomator。 

更 重要 的 是 ， 自 动 化 模拟 黑金 用 例 时 将 根据 需要 调用 多 个 接口 配合 完成 一 个 操作 ， 而 如 果 中 间 出 错 ， 我 们 很 难 定位 到 是 哪个 接口 有 问题 。 
 PPPPPPPEPPEPPEN 一 旦 报错 ， 我 们 可 以 很 清楚 地 定位 到 具体 接口 的 具体 方法 ， 非 常 方便 。 

fe 

他 区 那 咱们 以 后 用 CTS 取 代 其 他 框架 岂 不 更 好 ? 

eo 当然 不 行 ! 各 有 所 长 ，CTS 只 擅长 于 针对 单个 接口 具体 方法 的 测试 ， 能 做 到 像 CTS Verifier 一 样 稍微 偏 功 能 性 测试 已 经 不 易 ， 更 别 说 非常 复杂 的 自动 化 测试 。 
& 


ST, PRAM RARIOR] GAH Bit RY AT ARF 9 A) BEAT A GA! 


89. 你 进步 了 1 


78 ” Android 自动 化 工具 使 用 总 结 





要 想 开 发 新 工具 ， 需 得 先 下 苦 功 练 基础 ! 
eo, 了 ， 官 方 主流 自动 化 测试 框架 都 学 了 一 遍 了 ， 说 说 体会 吧 ! 
Se 
SAR PID T TŽ: monkey 父 子 属于 轻 量 级 自动 化 工具 ，Instrumentation 和 UIAutomator 则 是 重量 级 的 自动 化 测试 框架 ， 而 CTS 则 是 兼容 性 测试 框架 。 
CO A MES y Amo ikh 
那 什么 时 候 该 用 什么 工具 和 框架 ， 你 清楚 吗 ? 
Se 
全 普通 的 稳定 性 测试 和 一 些 简单 随机 测试 ， 用 monkey 就 可 以 。 
9o, 果 我 想 要 录制 回放 呢 ? 
s» 
< 人 <% 如 果 需 要 临时 录制 一 些 脚 本 而 不 用 考虑 脚本 移植 性 的 话 ， 可 以 用 monkeyrunnet 录 制 工 具 。 
ee, 不 过 自动 化 最 重要 的 应 该 是 将 用 例 转换 为 脚本 吧 ? 请 注意 ， 我 说 的 脚本 是 稳定 性 强 ， 移 植 性 好 的 脚本 。 
如果 是 这 样 ， 那 就 需要 动用 属 龙 刀 Instrumentation 和 倚天 剑 UIAutomator 了 ， 这 两 者 的 优 劣势 奔 哥 已 经 分 析 过 ， 大 家 根据 需要 进行 选择 吧 ! 
eo. 了 ， 这 次 项 目 结束 前 需要 做 一 下 兼容 性 测试 ， 这 个 是 用 CTS 吧 ? 
< 呵呵 ， 看 来 BOSS 都 学 会 了 1 
OS, naan, 如 果 这 些 工具 还 是 不 够 用 ， 需 要 开发 新 工具 ， 你 知道 从 哪 入 手 吗 ? 
i 
全 % 额 ， 现 有 的 工具 还 没 用 熟 呢 ， 您 又 给 我 出 难题 了 ! 奔 哥 ， 你 说 咋 办 ? 
$9. onu, 就 需要 熟悉 现 有 工具 ， 了 解 现 有 工具 有 哪些 优势 和 不 足 ， 以 及 是 否 能 互补 。 
全 % 如 果 发 现 互补 不 了 呢 ? 
QO, ena ark, 不 过 在 开发 之 前 ， 必 须 先 做 好 一 件 事 。 
Tua? 
| NEM 了 解 现 有 工具 的 原理 ， 剖 析 现 有 工具 的 架构 ， 认 真 学 习 现 有 工具 的 源码 。 
s» 
全 % 哇 ， 我 最 怕 看 代码 了 ， 头 大 ! 这 件 事 能 不 能 不 做 ? 


eo, 不 能 ， 只 有 立足 于 现 有 工具 的 原理 和 代码 ， 我 们 才能 对 二 次 开发 做 到 有 的 放 夭 。 
不 过 ， 我 尽量 用 最 浅显 的 语言 ， 用 最 简洁 的 分 析 带 领 你 迅速 走 过 这 最 难 赦 的 一 段 。 


fe 
人 % 好 ， 那 我 就 随 你 走 一 遭 吧 1! 


二 部 分 原理 篇 


“ 第 8 章 monkey 原 理 分 析 

' 第 9 章 ”monkeyrunner 原 理 分 析 

- 第 10 章 ”Instrumentation 原 理 分 析 

: 第 11 章 ”UIAutomatot 原 理 分 析 

“ 第 12 章 CTS 原 理 分 析 

: 第 13 章 Android 自 动 化 工具 源码 总 结 


在 开始 这 部 分 内 容 之 前 ， 先 对 本 书 源码 分 析 方 式 进行 郑重 声明 。 





让 暴风 雨 来 得 更 猛烈 些 吧 ! 


E 
人 区 奔 哥 ， 这 么 多 测试 工具 和 框架 ， 简 直 就 是 代码 的 海洋 ， 咱 们 从 何 处 入 手 呢 ? 


入 中 ,wp。， 玩 然 是 海洋 ， 那 响 们 就 一 个 猛 子 扎 进去 吧 ! 
RO eee 咱们 找到 一 个 入 海口 ， 就 扎 下 去 吧 ， 越 深 越 好 ! 
69... 你 们 这 样 瞎 胡 闪 ， 得 浪费 多 少时 间 啊 ? RAED? 成 本 ? | 
Ross, 我 们 用 工作 之 余 的 时 间 ， 请 别 打扰 我 们 愉快 地 玩 要 ! 
CO 


这 可 是 你 自己 说 的 ， 工 作 之 余 ， 千 万 不 要 在 上 班 时 让 我 还 着 你 ! 


Lr 
C des, Stk, Abt! 不 过 我 担心 咱们 这 一 个 猛 子 扎 深 了 ， 最 后 还 出 得 来 吗 ? 





， 我 也 不 敢 肯 定 ， 不 过 咱们 可 以 在 海底 深 处 循 着 线索 慢 慢 分 析 ， 逐 步 逐 步 在 暗礁 和 海沟 中 找寻 新 出 口 。 
全 区 我 读书 少 ， 你 别 骗 我 ! 我 看 人 家 牛人 分 析 代码 都 是 事先 将 源码 框架 、 结 构 、 功 能 逐条 地 展示 给 大 家 ， 不 会 一 上 来 就 扎 到 代码 中 去 。 


A 


PM 我 几时 骗 过 你 ? 你 说 的 这 种 方式 的 确 最 有 效率 ， 但 不 够 好 玩 。 


我 不 喜欢 自己 哺 完 代码 再 整理 提炼 好 给 大 家 吃 现成 的 。 我 更 喜欢 与 大 家 一 起 从 菜 个 点 一 头 扎 入 菜 片 海域 ， 一 起 哨 源码 ， 一 起 司 道 ， 边 看 边 总 结 ， 不 断 发 氢 新 宝物 的 过 程 。 
e. zuo no die why you try? 

eo, try I DIE Yu Ni HE GAN? 

m 

从 奔 可 ， 我 有 些 理解 你 的 想法 了 ， 大 家 在 看 的 过 程 中 肯定 会 党 得 混乱 而 混沌 ， 不 过 这 恰恰 是 读 代 码 的 乐趣 所 在 。 

POs, 就 是 这 样 ! 建议 大 家 可 以 先 读 源码 ， 再 看 本 书 的 分 析 ， 与 自己 的 分 析 相 对 照 ， 发 现 巴 哥 奔 的 错漏 之 处 ， 必 有 大 乐趣 ， 且 可 帮助 其 他 读者 ， 何 乐 而 不 为 ? 
P 

全 % 如 果 有 人 不 愿意 和 咱们 一 起 哨 代码 ， 咋 办? 

99. sgarcegas, 如 果实 在 无 此 耐心 可 以 先 看 每 一 节 的 总 结 ， 然 后 看 每 段 代码 的 详细 分 析 ， 最 后 再 看 代码 和 巴 哥 奔 的 注释 。 

fe 

CHR, Rape! 


ROn, 只 不 过 ， 如 此 一 来 ， 乐 趣 顿 失 ， 大 家 并 非 同道 中 人 ! SHU! 


第 8 章 monkey 原 理 分 析 





© g koi monkey R40 Tie 47, 不 看 源码 怎么 行 ? 


81 monkey 源码 结构 


go... 基础 篇 中 monkey 是 如 何 运行 的 吗 ? 


SSH, SUT, ASHARAXR S TUE! 
在 基础 篇 中 我 们 了 解 到 ，monkey 是 通过 如 下 脚本 运行 的 ， 如 代码 清单 8-1 所 示 。 


代码 清单 8-1 monkey 运 行 脚本 





base-/system 
export CLASSPATH-$base/framework/monkey.jar 
exec app process $base/bin com.android.commands.monkey.monkey $* 





这 里 简单 解释 一 下 此 脚本 ， 如 代码 清单 8-2 所 示 。 





代码 清单 8-2 ”注释 后 的 运行 脚本 


4 将 base 设 为 System 路 径 

base-/system 

# 将 monkey.jar 路 径 设置 为 CLASSPRATH 环 境 变量 

export CLASSPATH-$base/framework/monkey.jar 

# iüitapp process4 4-8 smonkey 

exec app process $base/bin com.android.commands.monkey.monkey $* 





通过 脚本 我 们 不 难 发 现 ， 该 批 处 理 通 过 app_process 命 令 指 向 的 是 “com.android.commands.monkey.monkey” 包 。 
Lr] 


SARA, RAN EHH EM ILI? 


monkeyjRiS(iZF "~\development\cmds\monkey\src\com\android\commands\monkey” 





源码 树 中 ， 如 








8-1 所 示 。 


[ 





findroid.mk 

example. script.txt 
MODULE LICENSE fiPACHE2 
monkey 

NOTICE 
README . NETWORK. t xt 


rc 
L— com 
L—-andro id 
ommands 
onkey 

Monkey. java 
Monke yActivit yEvent. java 
Monke yCommandEvent. java 
Monke yEvent. java 
Monke yEvent Queue. java 
Monke yEventSource. java 
MonkeyFlipEvent. java 
Monke yGetAppFrameRateEvent. java 
Monke yGet FrameRateEvent. java 
MonkeyInstrumentationEvent. java 
Monke yKe yEvent . java 
Monke yMot ionEvent. java 
Monke yNetworkMonitor. java 
Monke yNoopEvent. java 
Monke yPowerEvent. java 
Monke yRotat ionEvent. java 
Monke ySourceNetwork. java 
Monke ySourceNetvorkUars . java 
Monke ySourceNetworkViews . java 
Monke ySourceRandon. java 
Monke ySourceRandonmScript. java 
MonkeySourceScript. java 
MonkeyThrott leEvent. java 
Monke yTouchEvent. java 
MonkeyTrackhallEvent. java 
Monke yUtils. java 
Monke wWiewException. java 
Monke yWaitEvent. java 








六 此 文件 都 是 做 什么 的 ? 它们 之 间 又 有 何 种 千 丝 万 线 的 关系 呢 ? 


8.2 monkey 架构 分 析 
8.2.1 ”旅程 开始 


go 既然 是 分 析 monkey， 自 然 要 从 monkey.java 文 件 入 手 ， 让 我 们 先 来 看 看 monkey.java 的 main() 方 法 。 
monkey.java 的 main0 方 法 ， 如 代码 清单 8-3 所 示 。 


代码 清单 8-3 monkeyjava::main() 





public static void main(String[] args) { 
// Set the process name showing in "ps" or "top" 
Process .setArgV0 ("com.android.commands monkey") ; 
int resultCode - (new monkey ()) .run (args) ; 
System.exit (resultCode); 





EC] 
全 一 看 代码 头 就 大 ， 奔 哥 快 来 解释 下 。 


eo... 人 艰 不 拆 ， 解 释 如 下 。 
详细 说 明 如 下 。 


1) 将 进程 名 加 入 进程 列表 : 通过 Process.setArgV0("com.android.commands.monkey"); 将 该 进程 名 ( 即 com.android.commands.monkey) 加 入 到 进程 显示 列表 中 ， 以 便 通 过 ps 或 top 命 令 进 行 显 


2) 运行 monkey: 通过 (new monkey(0).run(args) 运 行 nonkey。 











3) 退出 : 在 运行 完成 后 将 结果 返回 给 resultCode 以 便 退 出 时 使 用 ， 即 System.exit(resultCode)。 

















所 以 ， 我 们 关注 的 重点 自然 是 new monkey(0).run(args)， 即 monkey.java 的 run(string[]args) 方 法 。 








8.2.2 从 run() 启 程 


eso 大 家 准备 好 了 吗 ? 咱们 从 run0 正 式 启 程 了 ! 
进入 run() 方 法 的 第 一 段 代 码 ， 如 代码 清单 8-4 所 示 。 


代码 清单 8-4 monkeyjava::run(0 的 第 一 段 代码 


private int run(String[] args) { 
// xuben: 首先 查看 monkey 命令 后 面 参数 是 否 有 "--wait-dbg" 参 数 
// 若 有 该 参数 则 进入 debug 状 态 
for(String s : args) ( 
if("--wait-dbg".equals(s)) ( 
Debug.waitForDebugger () ; 
} 


} 

// xuben: 对 部 分 参数 进行 默认 设置 

mVerbose = 0; 

mCount = 1000; 

mSeed - 0; 

mThrottle = 0; 

// xuben: 将 nonkey 参 数字 串 赋值 给 mArgs 

mArgs = args; 

mNextArg = 0; 

// xuben: *fmFactors[]4t2R CX Wok, ix ECC ET TAR" pc C-XXX" 8 KAM, 

// 如 和 触摸 "--pct-touch"、 动 作 "--pct-motion"、 轨 人 迹 球 "--pct-trackball" 等 ， 

// 被 nextOptionLong (final String opt) 方 法 转换 成 long 型 变量 的 值 

for(int i = 0; i < monkeySourceRandom.FACTORZ COUNT; i++) { 
mFactors[i] = 1.0f; 

} 





= 出 ，run0 将 处 理 monkey 对 应 的 各 种 命令 行 参数 。 





这 里 ， 我 们 遇 到 了 第 一 个 重要 常量 : monkeySourceRandom.FACTORZ COUNT, 于 是 我 们 先 插入 到 monkeySourceRandom.java 中 一 探究 竟 ， 再 回来 分 析 run() 方 法 。 
小 插曲 1: 三 个 接口 


打开 monkeySourceRandom.java， 我 们 发 现 ， 它 实现 了 monkeyEventSource 提 供 的 接口 。 继 续 追 踪 到 monkeyEventSource.java， 如 代码 清单 8-5 所 示 。 


代码 清单 8-5 monkeyEventSource.java::monkeyEventSource() 





public interface monkeyEventSource { 
// xuben: 返回 下 一 个 monkey 事 件 
public monkeyEvent getNextEvent (); 
//xuben: 设置 1og 等 级 
public void setVerbose (int verbose); 
// xuben: 验证 预 置 条 件 是 否 满足 要 求 
public boolean validate(); 





E 
人 AK3 个 参数 看 上 去 提 有 用 ， 不 过 之 前 提 到 的 常量 呢 ? 


人 es 马上 分 解 ! 


让 我 们 再 回头 来 看 看 monkeySourceRandom.FACTORZ_ COUNT, 





monkeySourceRandom.java: : FACTORZ COUNT 





我 们 发 现 ， 它 是 一 个 final 常 量 。 





public static final int FACTORZ COUNT = 11; // should be last+1 














这 里 还 有 一 句 注释 ， 应 为 未 值 +1， 也 就 是 说 ， 应 该 比 其 上 所 有 值 都 大 。 我 们 可 以 顺便 看 看 上 面 都 有 哪些 值 ， 如 代码 清单 8-6 所 示 。 





代码 清单 8-6” monkey 动作 对 应 





public static final int FACTOR TOUCH 20; 
public static final int FACTOR MOTION =1; 
public static final int FACTOR_PINCHZOOM = 2; 
public static final int FACTOR_TRACKBALL = 3; 
public static final int FACTOR_ROTATION = 4; 
public static final int FACTOR_NAV -5; 
public static final int FACTOR MAJORNAV -6; 
public static final int FACTOR SYSOPS = 7; 
public static final int FACTOR APPSWITCH -8; 
public static final int FACTOR FLIP 29; 
public static final int FACTOR ANYTHING - 10; 





我 们 可 以 回顾 一 下 基础 篇 里 提 到 的 monkey 事 件 类 命令 ， 如 图 8-2 所 示 。 





P -f : 测试 脚本 名 运行 


— -s: 随机 运行 


l 


—-* --throttle : 指令 间 固 定时 间 间 隔 


--ptc-touch : 触摸 事件 百分比 
---ptc-motion : 动作 事件 百分比 
--ptc-trackball : 轨迹 球 事件 百分比 
--ptc-nav : 基本 导航 事件 百分比 
--ptc-majornav : 主要 导航 事件 百分比 
Monkey 事 件 类 命令 ”事件 百分比 - --ptc-syskeys : 系统 按键 事件 百分比 
---ptc-appswitch : 应 用 启动 事件 百分比 
keypress 
--ptc-anyevent: 不 常用 的 button 
其 他 类 型 事件 百分比 其 他 未 提 及 事件 














图 8-2 monkey 事 件 类 命令 


se 
TUR EAS AH ET EE RAKA! 


99 cxaza, monkey.java 中 的 那 段 for 循 环 就 是 为 所 有 “FACTOR_” 值 预 留 空间 。 


明白 这 个 ， 让 我 们 再 回 到 monkey.java 分 析 run(string[]Jargs) 方 法 的 第 二 段 代 码 。 





82.3 ”monkey 参 数 详解 


run() 方 法 的 第 二 段 代码 ， 如 代码 清单 8-7 所 示 。 


代码 清单 8-7 monkey.java::run(0 的 第 二 段 代码 





// xuben: 紧 接 着 ， 调 用 了 ProcessOptions () 和 loadPackageLists () 两 个 方法 
if(!processOptions()) { 
return -1; 


} 
if(!loadPackageLists()) { 
return -1; 


} 








个 函数 是 干 嘛 的 ? Gh GARE! 
先 来 看 看 processOptions()， 如 代码 清单 8-8 所 示 。 


代码 清单 8-8 monkey.java:processOptions() 





private boolean processOptions () 
// xuben: 如 果 参 数 长 度 小 Pisa 
if (mArgs.length < 1) { 
showUsage () ; 
return false; 


} 


try { 
String opt; 
// xuben: 通过 nextOption () 读 取 下 一 个 参数 
while ((opt = nextOption()) != null) { 


if (opt.equals("-s")) ( 
mSeed = nextOptionLong ("Seed"); 
else if (opt.equals("-p")) ( 
mValidPackages.add (nextOptionData ()); 
} else if (opt.equals("-c")) { 
mMainCategories.add (nextOptionData ()); 
else if (opt.equals("-v")) { 
mVerbose += 1; 


} else if (opt.equals ("--ignore-crashes")) ( 
mIgnoreCrashes = true; 
else if (opt.equals("--ignore-timeouts")) { 
mIgnoreTimeouts = true; 
else if (opt.equals ("--ignore-security-exceptions")) { 
mIgnoreSecurityExceptions = true; 
} else if (opt.equals ("--monitor-native-crashes")) { 
mMonitorNativeCrashes = true; 
else if (opt.equals("--ignore-native-crashes")) { 
mIgnoreNativeCrashes = true; 
} else if (opt.equals("--kill-process-after-error")) { 


mKillProcessAfterError = true; 
else if (opt.equals("--hprof")) { 
mGenerateHprof = true; 
} else if (opt.equals("--pct-touch")) { 
inti = MonkeySourceRandom. FACTOR TOUCH; 
mFactors[i] = -nextOptionLong ("touch events percentage"); 
} else if (opt.equals("--pct-motion")) ( 
inti = MonkeySourceRandom. FACTOR MOTION; 
mFactors[i] = -nextOptionLong ("motion events percentage"); 
} else if (opt.equals("--pct-trackball")) { 
inti - MonkeySourceRandom. FACTOR TRACKBALL; 
mFactors[i] = -nextOptionLong ("trackball events percentage"); 
} else if (opt.equals("--pct-rotation")) { 
inti - MonkeySourceRandom. FACTOR ROTATION; 
mFactors[i] = -nextOptionLong ("screen rotation events 
percentage"); 
} else if (opt.equals("--pct-syskeys")) { 
inti = MonkeySourceRandom. FACTOR SYSOPS; 
mFactors[i] = -nextOptionLong("system (key) operations 
percentage"); 
} else if (opt.equals ("--pct-nav")) { 
inti = MonkeySourceRandom. FACTOR NAV; 
mFactors[i] = -nextOptionLong ("nav events percentage"); 
} else if (opt.equals("--pct-majornav")) { 
inti - MonkeySourceRandom. FACTOR MAJORNAV; 
mFactors[i] = -nextOptionLong ("major nav events percentage"); 
] else if (opt.equals("--pct-appswitch")) { 
inti - MonkeySourceRandom. FACTOR APPSWITCH; 
mFactors[i] = -nextOptionLong ("app switch events percentage"); 
} else if (opt.equals("--pct-flip")) { 
inti = MonkeySourceRandom. FACTOR FLIP; 
mFactors[i] = -nextOptionLong ("keyboard flip percentage"); 
} else if (opt.equals ("--pct-anyevent")) { 
inti - MonkeySourceRandom. FACTOR ANYTHING; 
mFactors[i] = -nextOptionLong ("any events percentage"); 
} else if (opt.equals("--pct-pinchzoom")) ( 
inti - MonkeySourceRandom. FACTOR PINCHZOOM; 
mFactors[i] = -nextOptionLong (" "pinch zoom events percentage"); 
} else if (opt.equals("--pkg-blacklist-file")) { 
mPkgBlacklistFile = nextOptionData(); 
} else if (opt.equals("--pkg-whitelist-file")) ( 
mPkgWhitelistFile = nextOptionData(); 
} else if (opt.equals("--throttle")) { 
mThrottle = nextOptionLong("delay (in milliseconds) to wait 
between events"); 
} else if (opt.equals ("--randomize-throttle")) { 
mRandomizeThrottle - true; 
] else if (opt.equals("--wait-dbg")) ( 
// do nothing - it's caught at the very start of run() 
} else if (opt.equals ("--dbg-no-events")) { 
mSendNoEvents - true; 
} else if (opt.equals("--port")) { 
mServerPort = (int) nextOptionLong("Server port to listen on for 
commands") ; 
} else if (opt.equals("--setup")) { 
mSetupFileName = nextOptionData (); 
} else if (opt.equals("-f")) { 
mScriptFileNames.add (nextOptionData () ) ; 
} else if (opt.equals("--profile-wait")) { 
mProfileWaitTime = nextOptionLong("Profile delay" + 
" (in milliseconds) to wait between user action"); 
} else if (opt.equals("--device-sleep-time")) { 
mDeviceSleepTime = nextOptionLong("Device sleep time" + 
"(in milliseconds) ") ; 
} else if (opt.equals("--randomize-script")) { 
mRandomizeScript = true; 
} else if (opt.equals("--script-log")) { 
mScriptLog = true; 
} else if (opt.equals("--bugreport")) { 
mRequestBugreport = true; 
} else if (opt.equals ("--periodic-bugreport") ) { 
mGetPeriodicBugreport = true; 
mBugreportFrequency = nextOptionLong("Number of iterations") ; 
} else if (opt.equals ("-h' 
showUsage () ; 
return false; 
} else ( 
System.err.println("** Error: Unknown option: " + opt); 
showUsage () ; 
return false; 














} 


] catch (RuntimeException ex) { 
System.err.println("** Error: " + ex.toString()); 
showUsage () ; 
return false; 


// If a server port hasn't been specified, we need to specify 
// a count 
if (mServerPort == -1) { 
String countStr - nextArg(); 
if (countStr == null) { 
System.err.println("** Error: Count not specified"); 
showUsage () ; 
return false; 
} 
try { 
mCount = Integer.parseInt (countStr); 
} catch (NumberFormatException e) { 


NT: 
令 行 


System.err.println("** Error: Count is not a number"); 
showUsage () ; 
return false; 
l 
} 


return true; 





段 代码 实在 太 长 了 ， 看 着 看 着 我 就 器 起 来 了 ! 


eo. 不 是 吧 ? 其 实 很 多 很 长 的 代码 非常 简单 。 有 的 代码 只 有 几 句 ， 反 而 复杂 得 要 命 ， 以 后 你 就 知道 了 。 




















四 














这 段 代码 看 似 很 长 ， 其 实 就 做 了 一 件 事 一 一 匹配 monkey 命 令 的 所 有 参数 (包括 前 
参数 启动 不 同 的 事件 源 。 











让 我 们 根据 monkey 针 对 不 同 参数 的 处 理 为 这 些 参数 进行 简单 分 类 。 














(1) 以 下 参数 将 调用 nextOptionData() 








“"--setup": 赋值 给 mSetupfileName， 该 变量 为 setup 脚 本 名 。 





+ "\£": 添加 到 mScriptfileNames， 该 变量 为 monkey 脚 本 名 称 。 

Sp": 添加 到 mValidPackages， 该 变量 为 允许 运行 的 Packages 名 。 

Dec": 添加 到 mmainCategories， 该 变量 为 允许 启动 的 Categoties 名 。 

+ "-pkg-blacklist-file": 赋值 给 mPkgBlacklistfile， 该 变量 为 Packages 的 黑 名 单 。 


- "pkg-whitelist-file": 赋值 给 mPkgWhitelistfile， 该 变量 为 Packages 的 白 名 单 。 











(2) 以 下 参数 将 调用 nextOptionLong0 





“"-s"; 赋值 给 mSeed， 该 变量 为 随机 数 seed。 

- "—throttle": mThrottle， 该 变量 为 输入 延迟 。 

-port": mServerPort， 该 变量 为 TCP 端 口 。 

- "—profile-wait": mProfileWaitTime， 该 变量 为 monkey 脚 本 中 的 延迟 时 间 。 

- "—device-sleep-time": mDeviceSleepTime ， 该 变量 为 monkey 脚 本 中 的 设备 空闲 时 间 。 
--periodic-bugreport": mBugreportFrequency， 该 变量 为 Bugreport 频 率 。 
…"--pct-touch": Wi 24mFactors[i], i#monkeySourceRandom.FACTOR_TOUCH. 
-"-pet-motion": Wi 2mFactors[i], i#monkeySourceRandom.FACTOR_MOTION. 
*"—pct-trackball": 4&4ü Z&mFactors[i], i#monkeySourceRandom.FACTOR_TRACKBALL. 
—pct-rotation": Xf Z&mFactors[i], i7) monkeySourceRandom.FACTOR. ROTATION, 
…"--pct-syskeys": 赋值 给 mFactors 四 ，i 为 monkeySourceRandom.FACTOR_SYSOPS。 


“"--pct-nav": WH 24mFactors[i], i#%monkeySourceRandom.FACTOR_NAV. 





:"—pct-majornav": WUA 24mFactors[i], i#monkeySourceRandom.FACTOR_MAJORNAV. 
+ "“-pet-appswitch": 4 24mFactors[i], i #monkeySourceRandom.FACTOR_APPSWITCH. 
+ "pet-flip": Wi ZemFactors[i], i%#monkeySourceRandom.FACTOR_FLIP. 


-"—pctanyevent": RA4É Z&mFactors[i], i79 monkeySourceRandom.FACTOR. ANYthings 





-pct-pinchzoom": Jf Z&mFactors[i], i79 monkeySourceRandom.FACTOR pinchzoom. 

(3) 以 下 参数 将 返回 true 

+ "—ignore-crashes": 赋值 给 mIgnoreCrashes， 该 变量 为 运行 时 忽略 所 有 应 用 崩 涡 。 

- "—ignore-timeouts": 赋值 给 mIgnoreTimeouts， 该 变量 为 运行 时 忽略 响应 超时 。 

- "—ignore-security-exceptions": 赋值 给 mIgnoreSecurityExceptions， 该 变量 为 运行 时 忽略 启动 应 用 的 安全 异常 。 


- "—ignore-native-crashes": 赋值 给 mIgnoreNativeCrashes， 该 变量 为 运行 时 忽略 所 有 native 异 常 。 


跳 转 到 debug 模 式 的 参数 “--wait-dbg” , RAW! 





在 这 里 该 参数 不 必 做 任何 


“"--monitor-native-ctashes": 赋值 给 mMonitorNativeCrashes， 该 变量 为 运行 时 若 出 现 新 文件 则 监控 /data/tombstones (该 文件 夹 下 存储 错误 报告 ) 。 


- "—kill-process-after-error": 赋值 给 mKillProcessAfterError， 该 变量 为 运行 时 出 现 error 则 杀 掉 进程 。 

- "—hprof': 赋值 给 mGenerateHprof， 该 变量 为 生成 hprof 报 告 。 

- "—-randomize-throttle": 赋值 给 mRandomizeThrottle， 该 变量 为 插入 随机 输入 延迟 (0-mThrottle ms) o 

- "—dbg-no-events": 赋值 给 mSendNoEvents， 该 变量 为 不 发 送 任何 事件 ， 通 过 长 延迟 观察 用 户 操 作 。 


- "—randomize-script": 赋值 给 mRandomizeScript， 该 变量 为 是 否 随机 运行 monkey 脚 本 。 


有 ) ， 并 为 对 应 变量 赋值 ， 以 便 根据 命 


. "sctiptlog"， 赋值 给 mmScriptLog， 该 变量 为 是 否 记录 monkey 脚 本 日 志 。 

*"—bugreport": 赋值 给 mRequestBugreport， 该 变量 为 运行 前 溃 时 捕获 bugreprot。 

+ "-periodic-bugreport": 赋值 给 mGetPeriodicBugreport， 该 变量 为 根据 bugrebort 频 率 〈 即 mBugreportFrequency 变 量 ) 调用 bugreport。 
(4) 以 下 参数 将 mVerbose+=1 


"v": 增加 log 日 志 级 别 。 











(5) 以 下 参数 将 调用 showUsage(0: 显示 帮助 信息 





.hn。 


(6) 以 下 参数 只 都 不 干 





"--wait-dbg": 在 run() 方 法 开始 时 就 判断 是 否 跳 转 到 debug 模 式 。 





:— ——— 
$9, us, 这 里 用 到 了 nextOption0 方 法 ， 通 过 它 读 取 monkey 命 令 后 面 的 下 一 个 参数 。 
了 解 了 nextOption0 函 数 ， 我 们 也 能 学 着 写 接受 参数 的 脚本 了 ， 让 我 们 进去 看 看 吧 ! 

8.2.4 ”如 何 细 分 参数 ? 


nextOption() 函 数 ， 如 代码 清单 8-9 所 示 。 


代码 清单 8-9 monkey.java::nextOption() 





/** 
* Return the next command line option. This has a number of special cases 
* which closely, but not exactly, follow the POSIX command line options 
* patterns: 
* <pre> 
* -- means to stop processing additional options 
* -z means option z 
* -z ARGS means option z with(non-optional) arguments ARGS 
* -zARGS means option z with(optional) arguments ARGS 
* —zz means option zz 
* 


--zz ARGS means option zz with(non-optional) arguments ARGS 
* «/pre» 
*@xuben: 上 面 这 段 注释 值得 细 读 ， 它 详细 地 说 明了 参数 设计 的 规则 ， 大 家 可 以 
* 先 回顾 一 下 基础 篇 关于 monkey 常 用 讲解 。 简 单 解释 如 下 。 
* 首 先 ， 参 数 前 有 一 道 杠 ("-") 和 两 道 杠 ) 之 分 ， 若 只 有 两 道 杠 而 不 接 参 数 ， 
* 参 数 与 参数 之 间 没有 空格 ， 说 明 参 数 输 入 错误 ; 
* 其 次 ， 一 道 杠 对 应 的 参数 字母 也 只 有 一 个 ， 两 道 杠 对 应 的 参数 字母 为 多 个 ; 
* 第 三 ， 若 为 "参数 + 空格 HARGS" 情 况 ， 则 表示 参数 带 了 非 可 选 参 数 RRGS， 若 
* 为 "参数 +ARGS" (只 适用 于 一 道 杠 情况 ) 则 表示 参数 带 了 可 选 参 数 ARGS。 


» 






E 





* Note that you cannot combine single letter options; -abc !- -a -b -c 
* 


* (return Returns the option string, or null if there are no more options. 
uid 
private String nextOption() { 
// xuben: 若 参 数 序号 大 于 存储 参数 的 数组 总 长 度 ， 则 返回 空 
if (mNextArg >= mArgs.length) { 
return null; 


l 
// xuben: 获取 该 参数 
String arg = mArgs [mNextArg]; 
// xuben: 若 参数 不 是 以 横 杠 开头 ， 则 返回 空 
if (larg.startsWith("-")) ( 
return null; 
} 
mNextArg++; 
// xuben: 若 参数 只 是 两 道 杠 ， 则 返回 空 
if (arg.equals("--")) ( 
return null; 


l 
// xuben: 要 求 参数 长 度 大 于 1 并 且 只 有 一 道 杠 
if (arg.length() > 1 && arg.charAt(1) != '-') { 
// xuben: 若 参 数 长 度 大 于 2 则 从 第 3 位 开始 截取 (〈 即 参数 后 面 的 ARGS) 
// 给 mCurArgData， 并 返回 该 参数 前 2 位 ( 即 杠 和 参数 ) 
if (arg.length() > 2) { 
mCurArgData = arg.substring(2); 
return arg.substring(0, 2); 
} else { 
// xuben: 若 参数 长 度 等 于 2， 说 明 只 有 一 道 杠 和 和 参数， 参数 
// 后 没有 跟 ARRGS， 则 直接 返回 该 参数 
mCurArgData = null; 
return arg; 
} 
l 
// xuben: 若 参 数 长 度 小 于 1 或 有 两 道 杠 ， 则 将 mCurArgData ( 即 参 数 后 面 
// 的 ARGS) 置 为 空 ， 并 直接 返回 该 参数 
mCurArgData = null; 
return arg; 


读 到 这 里 ， 有 的 读者 可 能 会 感到 迷糊 : 为 什么 只 将 一 道 杠 后 面 的 ARGS 放 入 mCurArgData， 两 道 杠 后 面 的 ARGS 没 人 管 了 吗 ?比如 --throttle 后 面 的 <mili seconds> 该 怎么 办 ? 





其 实 ， 细 心 的 朋友 已 经 从 最 开始 的 注释 中 得 到 信息 一 一 此 处 只 处 理 了 “参数 +ARGS” 〈 即 中 间 没 有 空格 的 情况 ) ， 此 情况 只 有 一 道 杠 时 才 会 存在 ， 所 以 在 此 处 做 了 相应 的 处 理 。 


而 “参数 + 空格 +ARGS” 的 情况 在 一 道 杠 和 两 道 杠 时 都 存在 ， 这 里 并 没有 处 理 ， 为 什么 呢 ? 因为 空格 会 让 后 面 的 ARGS 被 识别 成 下 一 个 参数 ， 所 以 这 种 情况 必须 在 判断 中 做 处 理 。 











以 刚才 提 到 的 --throttle< milli seconds> 为 例 ， 上 面 的 判断 里 是 这 样 处 理 的 ， 如 代码 清单 8-10 所 示 。 








代码 清单 8-10 ”参数 --throttle 处 理 





else if (opt.equals ("--throttle")) 


mThrottle = nextOptionLong("delay(in milliseconds) to wait between events"); 








也 就 是 将 空格 后 面 的 ARGS 交 给 了 nextOptionLong0， 如 代码 清单 8-11 所 示 。 


代码 清单 8-11 nextOptionLong() 函 数 


private long nextOptionLong(final String opt) { 


long result; 
try { 


result = Long.parseLong (nextOptionData()); 
} catch (NumberFormatException e) { 
System.err.println("** Error: " + opt + " is not a number"); 


throw e; 


} 


return result; 





而 当 我 们 进入 nextOptionLong() 函 数 ， 我 们 会 发 现 ， 它 又 把 这 件 事 交 给 了 nextOptionData(0， 如 代码 清单 8-12 所 示 。 


代码 清单 8-12 ”nextOptionData() 函 数 


private String nextOptionData() ( 
if (mCurArgData != null) { 
return mCurArgData; 


} 


if (mNextArg >= mArgs.length) ( 


return null; 


} 


String data = mArgs [mNextArg]; 


mNextArg++; 
return data; 








82.5 导入 package 列 表 


分 析 完 processOptions()， 让 我 们 


《说 白 了 ， 转 了 一 圈 ， 还 是 通过 nextOptionData0 方 法 来 处 理 ， 处 理 完 后 再 进行 一 个 转换 。 








n 








到 run() 函 数 中 再 出 发 ， 这 次 需要 到 loadPackageLists() 函 数 中 看 个 究竟 ， 如 代码 清单 8-13 所 示 。 








代码 清单 8-13 monkey.java::loadPackageLists() 





// xuben: 本 函数 非常 简单 ， 将 发 生 error 的 情况 返回 false， 无 error 则 返回 true 
private boolean loadPackageLists() { 
// xuben: 条 件 比较 复杂 ， 稍 后 分 析 
if (((mPkgWhitelistFile != null) || (mValidPackages.size() > 0)) 
&& (mPkgBlacklistFile != null)) ( 
System.err.println("** Error: you can not specify a package blacklist " 
* "together with a whitelist or individual packages (via -p)."); 
return false; 


l 
// xuben: 调用 loadPackageListFromFile () 函数 
if ((mPkgWhitelistFile != null) 
&& (!loadPackageListFromFile (mPkgWhitelistFile, mValidPackages))) { 
return false; 


l 
// xuben: 调用 loadPackageListFromFile () 函数 
if ((mPkgBlacklistFile !- null) 
&& (!loadPackageListFromFile (mPkgBlacklistFile, mInvalidPackages))) ( 
return false; 


} 


return true; 


一 进入 这 个 方法 ， 就 发 现 初始 条 件 就 设立 得 很 复杂 ， 这 里 简单 解释 一 下 。 





首先 ， 检 查 mPkgWhitelistfile 是 否 非 空 ，mPkgWhitelistfile 为 “--pkg-whitelist-file” (该 变量 为 Packages 的 白 名 单 ) 后 跟 的 可 选 ARGS 或 mValidPackages.size() 是 否 大 于 0 ( 即 是 否 有 允许 运行 的 





package) ， 二 者 满足 其 一 即 可 














嗅 ， 原 来 是 黑白 名 单 大 第 查 啊 ! À 











汰 想起 来 辛 德 勒 的 名 单 ， 我 脑袋 是 不 是 秀 去 了? 





这 里 用 到 loadPackageListFromfile( 函 数 ， 让 我 们 进去 看 看 ， 如 代码 清单 8-14 所 示 。 








代码 清单 8-14 monkey.java::loadPackageLists() 


private static boolean loadPackageListFromFile (String fileName, HashSet<String> list) { 
// xuben: 本 方法 通过 读 取 文 件 (dwmPkgWhitelistFilesimPkgBlacklistFile) 
// 将 其 中 的 Package 名 逐一 加 入 到 列表 (如 mValidPackages 或 
// mInvalidPackages) 中 ， 若 添加 出 现 问题 则 返回 false 
BuferedReader reader = null; 


try { 
reader = new BuferedReader (new FileReader (fileName)); 
String s; 
while ((s = reader.readLine()) != null) ( 
S — s.trim(); 
if ((s.length() > 0) && (!s.startsWith("#"))) { 
list.add(s); 


} 


} catch (IOException ioe) { 
System.err.println (ioe) 


return false; 


) finally ( 


if (reader != null) { 


try { 


reader.close(); 


] catch (IOException ioe) ( 
System.err.println (ioe) 


} 
} 
} 


return true; 


Sms, APackagesHs 


T 





其 次 ， 检 查 mPkgBlacklistFile 是 否 非 空 ，mPkgBlacklistfile 为 “--pkg-blacklist-file” (该 变量 为 Packages 的 黑 名 单 ) 后 跟 的 可 选 ARGS。 





名 单一 旦 有 值 ， 则 Packages 的 白 名 单 或 允许 运行 的 package 列 表 中 就 不 能 有 值 ， 否 则 返回 false。 然 后 将 




















白 名 单 文件 中 的 package 加 入 到 





ASP let, HR 
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package 加 入 到 黑 名 单列 表 中 ， 若 添加 出 错 也 返回 false。 


这 些 工 作 做 完 而 没有 出 现任 何 问题 ， 则 返回 true。 
go... ue 列表 ， 接 下 来 咱们 继续 回 到 主 旅程 中 来 ! 
EC 
S, Fiz SUY TE? 

8.2.6 monkey 的 系统 日 志 


若 processOptions0 和 loadPackagelLists( 均 返回 true， 那 我 们 就 可 以 大 踏步 前 进 ， 如 代码 清单 8-15 所 示 。 








代码 清单 8-15 monkey.java::run() 第 三 段 代码 


// xuben: 添加 允许 启动 的 Categories， 稍 后 详 述 

if (mMainCategories.size() == 0) { 
mMainCategories.add (Intent .CATEGORY_LAUNCHER) ; 
mMainCategories.add (Intent .CATEGORY_ MONKEY) ; 


} 
// xuben: 车 我 们 未 指定 mSeed ( 即 "-s" 后 面 的 随机 数 seed) ，monkey 将 默认 
// 随机 数 = 系统 时 间 + 当 前 对 象 的 哈 希 码 
if (mSeed == 0) { 
mSeed = System.currentTimeMillis() + System.identityHashCode (this); 
} 
// xuben: 下 面 要 做 的 几 个 判断 均 是 基于 需要 日 志 的 命令 ( 即 
// 日 志 级 别 "-V" 至 少 有 1 个 ) 
if (mVerbose > 0) ( 
System.out.println(":Monkey: seed=" + mSeed + " count-" + mCount); 
// xuben: 接 下 来 显示 package 的 白 名 单列 表 ， 该 列表 即 是 通过 上 一 节 
// 提 到 的 loadPackageListFromFile() 函数 从 白 名 单 文件 中 添加 的 
if (mValidPackages.size() > 0) { 
Iterator<String> it = mValidPackages.iterator(); 
while (it.hasNext()) { 


System.out.println(":AllowPackage: " + it.next()); 
} 


// xuben: 然后 显示 Package 的 黑 名 单列 表 ， 原 理 同上 

if (mInvalidPackages.size() > 0) ( 
Iterator<String> it = mInvalidPackages.iterator(); 
while (it.hasNext()) { 


System.out.println(":DisallowPackage: " + it.next()); 
} 


// xuben: 最 后 显示 刚才 我 们 提 到 的 系统 启动 类 别 

if (mMainCategories.size() != 0) { 
Iterator<String> it = mMainCategories.iterator(); 
while (it.hasNext()) { 


System.out.println(":IncludeCategory: " + it.next()); 
} 


代码 分 析 如 下 。 

















1) 添加 人 允许 启动 的 Categories: 该 参数 (mmainCategories) 为 “-c” 后 面 的 可 选 ARGS。 我 们 在 基础 篇 monkey 的 约束 类 命令 中 提 到 过 ， 若 没有 在 “-c” 后 面 指定 系统 启动 类 别 ，monkey 将 为 我 们 
指定 Intent.CATEGORY_LAUNCHER 和 Intent.CATEGORY_MONKEY， 说 的 就 是 这 里 。 


2) 默认 随机 数 : 若 我 们 未 指定 mSeed ( 即 “-s” 后 面 的 随机 数 seed) ，monkey 将 默认 随机 数 = 系统 时 间 + 当 前 对 象 的 哈 希 码 。 






































3) 黑白 名 单 : 显示 package 的 白 名 单 和 黑 名 单列 表 ， 该 列表 即 是 通过 上 一 节 提 到 的 loadPackageListFromfile() 函 数 从 白 名 单 和 黑 名 单 文件 中 添加 的 。 





4) 系统 启动 类 别 : 最 后 显示 刚才 我 们 提 到 的 系统 启动 类 别 。 





这 就 构成 了 monkey 的 系统 日 志 。 














接 下 来 ， 要 运行 如 下 3 个 方法 ， 如 代码 清单 8-16 所 示 。 


代码 清单 8-16 run() 函 数 三 个 方法 





// xuben: 检查 内 部 配置 
if (!checkInternalConfiguration()) ( 
return -2; 


} 
// xuben: 构建 三 大 能 力 
if (!getSystemInterfaces()) { 
return -3; 


} 

// xuben: 获取 合法 package 列 表 

if (!getMainApps()) { 
return -4; 


) 





端 一 过 茶 ， 咱 们 逐个 进去 溜达 溜达 吧 ! 
82.7 ”检查 内 部 配置 


先 来 看 看 第 一 个 方法 : checkinternalConfiguration()， 如 代码 清单 8-17 所 示 。 


代码 清单 8-17 monkey.java::checkinternalConfiguration() 





monkey. java: :checkInternalConfiguration () 
private boolean checkInternalConfiguration() { 
return true; 








< 





这 就 完了 ? 这 也 太 不 负责 任 了 吧 ? 


95... 的 确 是 ，Android 4.2 之 前 该 函数 会 检查 内 部 配置 是 否 正确 ， 不 过 4.2 后 该 功能 形同虚设 。 


Android 4.2 之 前 该 函数 会 检查 内 部 配置 是 否 正确 (如 monkeySourceRandom.java 的 KEY_NAMES 变 量 是否 与 KeyEvent.java 里 的 KEYCODE 的 数量 保持 一 致 等 ) 。 





但 在 Android 4.2 的 代码 中 ， 该 函数 检查 功能 已 去 掉 ， 目 前 函数 将 直接 返回 true。 




















8.2.8 构建 三 大 能 


本 函数 也 比较 简单 ， 分 别 获 取 ActivityManager 对 象 、WindowManager 对 象 和 PackageManager 对 象 ， 若 获取 失败 则 报错 并 返回 false， 如 代码 清单 8-18 所 示 。 


代码 清单 8-18 monkey java::getSysteminterfaces() 


private boolean getSystemInterfaces() { 
// xuben: 获取 ActivityManager， 失 败 报错 并 返回 false 
mAm = ActivityManagerNative.getDefault (); 


i£ 


(mam == null) { 
System.err.println("** Error: Unable to connect to activity manager; is the 


+ " system running?"); 
return false; 


} 

// xuben: 获取 WindowManager， 失 败 报错 并 返回 false 

mWm = 

IWindowManager.Stub.asInterface (ServiceManager.getService ("window")); 


if 


(mWm — null) ( 


System.err.println("** Error: Unable to connect to window manager; is the 
* " system running?"); 
return false; 


l 
// xuben: 获取 PackageManager， 失 败 报错 并 返回 false 
mPm = IPackageManager.Stub.asInterface (ServiceManager.getService ("package") ) ; 


if 


} 


(mPm == null) ( 


System.err.println("** Error: Unable to connect to package manager; is the 
+ " system running?"); 
return false; 


try { 


// xuben: ii itmNetworkMonitorié #HActivityManager* $- 
mAm.setActivityController (new ActivityController()); 
mNetworkMonitor.register (mAm); 


} catch (RemoteException e) { 


} 


System.err.println("** Failed talking with activity manager!"); 
return false; 


return true; 








这 里 获取 ActivityManager 对 象 、WindowManager 对 象 和 PackageManager 对 象 是 做 什么 的 呢 ? 


86... 涉及 monkey 需 要 通信 的 3 个 重要 系统 服务 ， 具 体 解释 如 下 。 




















这 里 涉及 monkey 需 要 通信 的 3 个 重要 系统 服务 ， 以 具备 更 为 强大 的 能 





1) 控制 测试 生命 周期 能 力 : 通过 ActivityManager 调 用 setActivityController() 方 法 对 整个 测试 生命 周期 进行 控制 。 









































2) 注入 事件 的 能 力 : 通过 调用 WindowManage 中 提供 的 方法 使 得 monkey 可 顺利 注入 事件 (如 点 击 事件 、 按 键 事件 等 ) 到 应 





3) 应 用 间 切 换 能 力 : 通过 PackageManager 获 取 Intent 中 的 应 用 列表 以 便 在 测试 时 可 在 多 个 应 用 之 间 随 机 切换 。 


而 注册 则 是 通过 mNetworkMonitor.register(mAm)， 细 心 的 读者 应 该 已 经 发 现 mNetwork-Monitor 即 为 monkeyNetworkMonitor 对 象 ， 这 就 将 我 们 带 到 一 个 和 


monkeyNetworkMonitor.javarg, 


小 插曲 2: Android 系 统 的 广播 机 制 











看 要 的 monkey 文 件 一 一 


我 们 先 看 看 monkeyNetworkMonitorjava 中 的 register( 函 数 ， 里 面 调用 了 IActivityManager am.registerReceiver()， 这 就 涉及 了 Android 系 统 的 广播 机 制 ， 如 代码 清单 8-19 所 示 。 











代码 清单 8-19 monkeyNetworkMonitor.java::register() 





public void register(IActivityManager am) throws RemoteException ( 
if(LDEBUG) System.out.println("registering Receiver"); 
am.registerReceiver(null, null, this, filter, null, UserHandle.USER ALL); 


} 


看 到 registerReceiver， 不 知道 有 多 少 读者 会 联想 到 广播 机 制 中 接收 者 把 广播 接收 器 注册 到 ActivityManagerService 这 关键 的 一 步 如 代码 清和 


代码 清单 8-20 ActivityManagerNative.java::registerReceiver() 








8-20 所 示 。 








public Intent registerReceiver (IApplicationThread caller, String packageName, 
IIntentReceiver receiver, IntentFilter filter, String perm, int userId) 
throws RemoteException 


Parcel data - Parcel.obtain(); 
Parcel reply = Parcel.obtain(); 
data.writeInterfaceToken (IActivityManager.descriptor) ; 


data.writeStrongBinder (caller != null ? caller.asBinder() : null); 
data.writeString (packageName) ; 
data.writeStrongBinder (receiver != null ? receiver.asBinder() : null); 


filter.writeToParcel (data, 0); 
data.writeString (perm) ; 
data.writeInt (userId); 
mRemote.transact (REGISTER RECEIVER TRANSACTION, data, reply, 0); 
reply.readException(); ` 7 
Intent intent = null; 
int haveIntent = reply.readInt (); 
if(haveIntent != 0) { 
intent = Intent.CREATOR.createFromParcel (reply); 


} 


reply.recycle(); 
data.recycle(); 
return intent; 


各 自 的 Receiver 都 是 通过 实现 BroadcastReceiver 接 口 来 完成 的 (将 Receiver 放 在 Activity-Thread 线 程 里 处 理 ) ， 因 为 Broadcast 是 从 ActivityManagerService 发 出 的 ， 只 要 ActivityManagerService 接 
收 到 该 Receiver 即 可 。 而 这 一 切 ， 正 是 通过 这 个 ActivityManagerNative.registerReceiver() 完 成 的 。 











这 里 通过 monkeyNetworkMonitor.registerReceiver() 传 入 的 Intentfilter 为 Intentfilter(ConnectivityManager.CONNECTIVITY_ACTION)， 此 处 的 action 监 听 网 络 状态 是 否 改变 。 


8.2.9 获取 合法 package 列 表 


= eso 就 做 了 一 件 事 : 将 合适 的 Package 添 加 到 MmainApps 列 表 中 。 
获取 合法 package 列 表 ， 如 代码 清单 8-21 所 示 。 


代码 清单 8-21 monkey.java::getmainApps() 





private boolean getMainApps() { 
try { 
final int N = mMainCategories.size(); 
for (int i= 0; i< N; i++) { 
Intent intent = new Intent (Intent.ACTION MAIN); 
String category = mMainCategories.get (i); 
if (category.length() > 0) { 
intent .addCategory (category); 
l 
// xuben: i&itqueryIntentActivities () 检 查 RP 是 否 有 
// 注册 了 Intent .ACTION_MAIN 
List«ResolveInfo» mainApps = mPm.queryIntentActivities (intent, null, 0, 
UserHandle.myUserId()); 


if (mainApps == null || mainApps.size() == 0) ( 
System.err.println("// Warning: no activities found for category " 十 
category); 
continue; 
} 
if (mVerbose >= 2) { // very verbose 
System.out.println("// Selecting main activities from category " + 
category); 


} 
final int NA = mainApps.size(); 
for (int a = 0; a < NA; act) { 
ResolveInfo r = mainApps.get (a); 
String packageName - r.activityInfo.applicationInfo.packageName; 
// xuben: 检查 该 package 是 否 在 合法 pkg 列 表 (mValidPackages) 
// 中 及 不 在 非法 pkg 列 表 (mInvalidPackages) 中 
if (checkEnteringPackage (packageName)) { 
if (mVerbose >= 2) { // very verbose 
System.out.println("// + Using main activity " + 
r.activityInfo.name + "(from package 
+ packageName + ")"); 


l 
// xuben: 将 合法 pkg 添 加 到 mMainApps 列 表 中 
mMainApps.add (new ComponentName (packageName, 
r.activityInfo.name)); 
} else { 
if (mVerbose >= 3) { // very very verbose 
System.out.println("//  - NOT USING main activity " 
+ r.activityInfo.name + " (from package " + packageName + ")"); 
} 


} 


} catch (RemoteException e) { 
System.err.println("** Failed talking with package manager!"); 
return false; 


} 

if (mMainApps.size() == 0) { 
System.out.println("** No activities found to run, monkey aborted."); 
return false; 

} 


return true; 





详细 说 明 如 下 。 











1) 检查 合法 应 用 包 名 : 首先 通过 checkEnterfingPackage(packageName) 检 查 本 次 monkey 运 行 合法 package 应 用 包 名 。 





2) 获取 对 应 包 的 组 件 名 : 通过 ComponentName(packageName,r.activityinfo.name) 得 到 这 些 包 的 组 件 (component) 名 。 
3) 将 组 件 添加 到 列表 : 将 这 些 合法 组 件 加 入 到 mmainApps 列 表 中 。 


而 mmainApps 则 为 稍 后 传 入 monkeySourceRandom() 做 准备 。 





mEventSource = new monkeySourceRandom(mRandom, mMainApps, mThrottle, 
mRandomizeThrottle) 





monkeySourceRandom()、monkeySourceScript0、monkeySourceRandomscript0 和 monkeySourceNetwork() 等 4 个 方法 分 别处 理 monkey 的 不 同情 况 (随机 运行 、 脚 本 运行 、 随 机 脚本 运行 和 远 





全 5 那么 ， 这 些 不 同 运行 模式 又 分 别 是 干 嘛 的 呢 ? 
$9... 接 下 来 我 们 就 逐个 分 析 各 种 运行 模式 吧 1 


8.2.10 ”monkey 运 行 模式 汇总 





继续 看 run0 代 码 ， 接 下 来 这 一 段 非常 有 意思 ，monkey 的 各 种 运行 情况 都 将 在 此 逐一 展现 ， 如 代码 清单 8-22 所 示 。 


代码 清单 8-22 ”monkeyjava:run() 第 四 段 代码 





// xuben: 获取 随机 数 
mRandom = new Random (mSeed); 
// xuben: 若 monkey 后 续 参 数 中 有 脚本 ( 即 有 "-f" 选 项 ) ， 且 脚本 数 等 于 1， 
// 则 通过 monkeySourceScript 直 接 运 行 该 脚本 
if (mScriptFileNames != null && mScriptFileNames.size() == 1) { 
// script mode, ignore other options 
mEventSource = new MonkeySourceScript (mRandom, 
mScriptFileNames.get(0), mThrottle, mRandomizeThrottle, 
mProfileWaitTime, mDeviceSleepTime); 
mEventSource.setVerbose (mVerbose); 
mCountEvents = false; 
// xuben: 车 monkey 后 续 参 数 中 有 脚本 ( 即 有 "-f" 选 项 ) ， 且 脚本 数 大 于 1， 
// 则 需要 先 区 分 后 续 脚 本 是 否 包含 Setup 脚 本 ( 即 是 否 有 "--setup "选项 ) 
} else if (mScriptFileNames != null && mScriptFileNames.size() > 1) ( 
// xuben: 若 后 续 脚本 包含 Setup 肢 本 ( 即 有 "--setup "选项 ) 
// 则 先 运行 Setup 肢 本 ， 再 随机 运行 其 它 脚本 
if (mSetupFileName != null) { 
mEventSource = new MonkeySourceRandomScript (mSetupFileName, 
mScriptFileNames, mThrottle, mRandomizeThrottle, mRandom, 
mProfileWaitTime, mDeviceSleepTime, mRandomizeScript); 


mCount++; 
// xuben: 若 后 续 脚本 不 包含 setup 脚 本 ( 即 没有 "--setup "选项 ) 
// 则 直接 随机 运行 所 有 脚本 
} else { 
mEventSource = new MonkeySourceRandomScript (mScriptFileNames, 
mThrottle, mRandomizeThrottle, mRandom, 
mProfileWaitTime, mDeviceSleepTime, mRandomizeScript) ; 
} 
mEventSource.setVerbose (mVerbose) ; 
mCountEvents = false; 
// xuben: 若 monkey 后 续 参 数 中 有 端口 ( 即 有 "-port" 选 项 ) 
// 则 需 通过 monkeySourceNetwork () 运行 远程 调用 
) else if (mServerPort != -1) ( 
try { 
mEventSource = new MonkeySourceNetwork (mServerPort) ; 
} catch (IOException e) { 
System.out.println("Error binding to network socket."); 
return -5; 
l 
mCount = Integer.MAX ' d 
// xuben: 若 没有 脚本 或 端口 ， 则 通过 monkeySourceRandom () 直接 随机 运行 即 可 


} else ( 
// random source by default 
if (mVerbose »- 2) ( // check seeding performance 


System.out.println("// Seeded: " * mSeed); 


l 
// xuben: 将 合法 package 列 表 mMainApps 传 入 到 monkeySourceRandom() 
// 中 以 供 稍 后 generateActivity() 调 用 
mEventSource = new MonkeySourceRandom (mRandom, mMainApps, 
mThrottle, mRandomizeThrottle); 
mEventSource. setVerbose (mVerbose); 
// xuben: 人 
// 此 处 将 循环 遍历 常用 事件 
for (int i = 0; i < MonkeySourceRandom.FACTORZ COUNT; i++) { 
if (mFactors[i] <= 0.0f) { E 
( (MonkeySourceRandom) mEventSource) .setFactors (i, mFactors[i]); 
} 


l 

// xuben: i&itmonkeySourceRandom.generateActivity () 生成 随机 应 用 事件 
// 并 通过 monkeyEventQueue .aqddList () 将 该 随机 应 用 事件 加 入 到 

// monkeyEventQueue 这 个 队列 中 去 。 这 里 又 涉及 两 个 文件 : 

// monkeyActivityEvent .javafemonkeyEventQueue. java 
((MonkeySourceRandom) mEventSource) .generateActivity (); 











详细 说 明 如 下 。 
1) 直接 运行 脚本 : 若 monkey 后 续 参 数 中 有 脚本 ( 即 有 “-f” 选项) ， 且 脚本 数 等 于 1， 则 通过 monkeySourceScript 直 接 运 行 该 脚本 。 





























2) 若 monkey 后 续 参数 中 有 脚本 ( 即 有 “-f” 选项 ) ， 且 脚本 数 大 于 1， 则 需要 先 区 分 后 续 脚 本 是 否 包含 setup 脚 本 ( 即 是 否 有 “--setup” 选 项 ) 。 








运行 setup 脚 本 : 若 后 续 脚本 包含 setup 脚 本 ( 即 有 “--setup” 选 项 ) ， 则 先 运行 setup 脚 本 ， 再 随机 运行 其 他 脚本 。 


- 随机 运行 所 有 脚本 : 车 后 续 脚本 不 包含 setup 脚 本 (FPA “setup” HM) 则 直接 随机 运行 所 有 脚本 。 




















3) 运行 远程 调用 : 若 monkey 后 续 参数 中 有 端口 ( 即 有 “--port” 选 项 ) , MF 

















通过 monkeySourceNetwork() 运 行 远程 调用 。 














4) 直接 随机 运行 : 若 没 有 脚本 或 端口 ， 则 通过 monkeySourceRandom() 直 接 随机 运行 即 可 。 




















E] 
Ak ss monkey 的 整个 运行 ， 在 头脑 中 一 下 子 清晰 起 来 ! 


89. uen 所 有 事件 源 都 初始 化 了 一 遍 ， 不 同 的 event soutce 会 有 不 同 的 类 来 做 相应 的 实现 〈 大 家 可 以 参照 这 些 实现 编写 相关 的 monkey 脚 本 以 满足 具体 测试 需求 ) 。 


小 插曲 3: monkey 脚 本 运行 


我 们 先 看 看 monkey 的 基本 脚本 处 理 。 很 简单 ， 就 是 将 相关 参数 (随机 数 、 输 入 延迟 和 随机 输入 延迟 ) 传 给 monkeyEventQueue 以 加 入 monkey 事 件 队列 ， 如 代码 清单 8-23 所 示 。 


代码 清单 8-23 monkeySourceScript.java::monkeySourceScript() 


// xuben: 创建 monkeySourceScript 实 例 
public monkeySourceScript (Random random, String filename, long throttle, 
boolean randomizeThrottle, long profileWaitTime, long deviceSleepTime) { 
mScriptFileName = filename; 
mQ = new monkeyEventQueue (random, throttle, randomizeThrottle); 
mProfileWaitTime = profileWaitTime; 
mDeviceSleepTime = deviceSleepTime; 





monkey 基 本 脚本 处 理 虽 然 简单 ， 却 是 monkey 脚 本 处 理 的 根本 。 

















值得 一 提 的 是 ， 在 基础 篇 中 我 们 用 到 的 monkey 常 用 API 均 出 自 monkeySourceScript.java， 对 应 源码 如 下 ， 如 代码 清单 8-24 所 示 。 
































代码 清单 8-24 monkey 常 用 API 对 应 

















// event key word in the capture log 

private static final String EVENT KEYWORD POINTER = "DispatchPointer"; 

private static final String EVENT KEYWORD TRACKBALL = "DispatchTrackball"; 

private static final String EVENT KEYWORD ROTATION = "RotateScreen"; 

private static final String EVENT KEYWORD KEY = "DispatchKey"; 

private static final String EVENT KEYWORD FLIP = "DispatchFlip"; 

private static final String EVENT KEYWORD KEYPRESS = "DispatchPress"; 

private static final String EVENT KEYWORD ACTIVITY = "LaunchActivity"; 

private static final String EVENT KEYWORD Instrumentation — "LaunchInstrumentation"; 

private static final String EVENT KEYWORD WAIT = "UserWait"; 

private static final String EVENT KEYWORD LONGPRESS = "LongPress"; 

private static final String EVENT KEYWORD POWERLOG = "PowerLog"; 

private static final String EVENT KEYWORD WRITEPOWERLOG = "WriteLog"; 

private static final String EVENT KEYWORD RUNCMD = "RunCmd"; 

private static final String EVENT KEYWORD TAP = "Tap"; 

private static final String EVENT KEYWORD PROFILE WAIT 

private static final String EVENT KEYWORD DEVICE WAKEUP 

private static final String EVENT KEYWORD INPUT STRING 

private static final String EVENT KEYWORD PRESSANDHOLD 

private static final String EVENT KEYWORD DRAG = "Drag" 

private static final String EVENT KEYWORD PINCH ZOOM = "PinchZoom"; 

private static final String EVENT KEYWORD START FRAMERATE CAPTURE = "StartCaptureFramerate"; 

private static final String EVENT KEYWORD END FRAMERATE CAPTURE = "EndCaptureFramerate"; 

private static final String EVENT KEYWORD : ) START J APP | FRAMERATE ; CAPTURE = 
"StartCaptureAppFramerate"; 

private static final String EVENT KEYWORD END APP FRAMERATE CAPTURE — "EndCaptureAppFramerate"; 

















太原 来 是 这 样 对 应 上 的 ， 明 白 了 ! 


ROn 咱们 再 来 看 看 随机 脚本 是 如 何 运行 的 ! 
小 插曲 4: monkey 随 机 脚本 运行 


Oan 先 看 看 有 setupfile 的 情况 。 



































为 setupfile 一 般 都 是 为 了 配置 环境 或 预 置 资源 所 用 ， 所 以 必须 放 在 最 前 面 ， 以 免 后 续 脚 




















在 有 setupfile 的 情况 下 ，setupfile 需 要 单独 提出 来 先 运行 ， 这 样 可 以 确保 setupfile 不 会 受到 随机 运行 的 影响 。 因 
本 运行 因为 缺少 环境 或 资源 而 运行 失败 ， 如 代码 清单 8-25 所 示 。 








代码 清单 8-25 monkeySourceRandomsScript.java::monkeySourceRandomScript() 





public MonkeySourceRandomScript (String setupFileName, ArrayList<String> scriptFileNames, 
long throttle, boolean randomizeThrottle, Random random, long 
profileWaitTime, long burro pud boolean randomizeScript) ( 
// xuben: de Xsetupfile/ 79 7, WM) Hii itmonkeySourceScript () 运行 sSetupfile 
if (setupFileName !- null) ( 
// xuben: 为 mCurrentSource 赋 值 ， 以 避免 setupFi1LeName 被 随机 运行 
mSetupSource = new MonkeySourceScript (random, setupFileName, throttle, 
randomizeThrottle, profileWaitTime, deviceSleepTime); 


mCurrentSource = mSetupSource; 


l 
// xuben: 运行 完 setupfile 后 ， 再 通过 monkeySourceScript () 随机 运行 其 他 文件 
for (String fileName: scriptFileNames) ( 
mScriptSources.add(new MonkeySourceScript (random, fileName, throttle, 
randomizeThrottle, profileWaitTime, deviceSleepTime)); 
} 
// xuben: 将 random 和 randomizeScript 分 别 赋 值 给 mRandom 和 
// mRandomizeScript， 大 家 可 以 想 想 这 两 个 参数 后 续 将 有 什么 作用 ? 
mRandom = random; 
mRandomizeScript = randomizeScript; 








| PP 
在 没有 setupfile 的 情况 下 ， 将 直接 把 setupfile 作 为 null 传 入 到 上 一 个 构造 函数 中 去 ， 所 有 monkey 脚 本 全 部 随机 运行 即 可 ， 如 代码 清单 8-26 所 示 。 




















代码 清单 8-26 monkeySourceRandomsScript() 


public monkeySourceRandomScript (ArrayList«String» scriptFileNames, long throttle, 
boolean randomizeThrottle, Random random, long profileWaitTime, longdeviceSleepTime, 


boolean randomizeScript) ( 
this(null, scriptFileNames, throttle, randomizeThrottle, random, profileWaitTime, 


deviceSleepTime, randomizeScript); 





不 难 发 现 ， 无 配置 文件 (Büsetupfile) 的 随机 脚本 运行 建立 在 有 配置 文件 的 随机 脚本 运行 基础 上 ， 而 这 两 者 的 根本 就 是 基本 脚本 运行 (monkeySourcescript) 。 


点 关注 mRandom 和 mRandomizeScript 两 个 被 赋值 的 参数 ， 后 续 monkey 脚 本 是 否 随机 运行 与 它们 不 无 关系 。 说 到 这 里 ， 就 让 我 们 一 起 看 看 getrNextEvent() 函 数 ， 如 代码 清香 








除 此 之 外 ， 大 家 需 
8-27 所 示 。 


代码 清单 8-27 monkeySourceRandomsScript::getNextEvent() 





public MonkeyEvent getNextEvent() { 
// xuben: mCurrentSource 在 有 setupfile 时 被 赋值 ， 即 当 该 monkey 脚 本 为 setupfile 
// 时 ， 该 配置 脚本 不 允许 被 随机 运行 
if (mCurrentSource == null) ( 
int numSources = mScriptSources.size(); 
// xuben: 当 脚 本 数 为 1 时 直接 运行 即 可 
if (numSources == 1) ( 
mCurrentSource = mScriptSources.get (0); 
// xuben: 当 脚 本 数 大 于 1 时 进入 判断 
) else if (numSources > 1 ) ( 

// xuben: 此 处 mRandomizeScript 开 始 发 威 ， 若 它 被 赋值 ， 则 随机 获 

// 取 下 一 个 脚本 数 ， 以 达到 随机 运行 脚本 目的 

if (mRandomizeScript) { 
mCurrentSource = 
mScriptSources.get (mRandom.nextInt (numSources)); 

} eise { 
mCurrentSource = mScriptSources.get (mScriptCount $ numSources) ; 
mScriptCount++; 

} 

} 
l 
if (mCurrentSource !- null) ( 
MonkeyEvent nextEvent = mCurrentSource.getNextEvent (); 
if (nextEvent — null) ( 
mCurrentSource - null; 


} 


return nextEvent; 


return null; 


Hr 











为 什么 非 要 实现 getNextEvent() 方 法 来 生成 并 获取 事件 呢 ? 





eo. 为 这 样 一 来 大 家 只 需要 调用 这 个 接口 的 getNextEvent() 方 法 就 可 以 获得 事件 源 


小 插曲 5: monkey 远 程 运 行 


monkey 远 程 运行 如 代码 清单 8-28 所 示 。 


代码 清单 8-28 monkeySourceRandomscriptjava::monkeySourceNetwork() 


public monkeySourceNetwork (int port) throws IOException { 
// xuben: 只 能 绑 定 本 地 主机 地 址 
serverSocket = new ServerSocket(port, 0, // default backlog 


InetAddress.getLocalHost ()); 


这 里 ， 通 过 指定 的 端口 实例 化 一 个 ServerSocket。 





< 全 沧 奔 哥 ， 难 道 这 样 就 能 对 指定 断 开 进行 监听 了 ? 


Oarra, 要 想 了 解 真正 对 断 开 监听 的 方法 ， 继 续 往 下 看 ! 








既然 monkeySourceRandomscriptjava 里 的 getNextEvent() 方 法 给 我 们 很 多 启示 ， 那 么 ，monkeySourceRandomscript.java 是 不 是 也 有 对 应 的 getNextEvent() 方 法 呢 ? 
果然 有 ， 赶 紧 进 去 瞧 瞧 ， 如 代码 清单 8-29 所 示 。 


代码 清单 8-29 monkeySourceRandomScript::getNextEvent() 





public MonkeyEvent getNextEvent() { 
if (!started) ( 

try { 
// xuben: 通过 startServer () 启动 
startServer(); 

} catch (IOException e) ( 
Log.e(TAG, "Got IOException from server", e); 
return null; 

} 


started = true; 


l 
// xuben: 开始 获取 下 一 个 命令 
try { 
while (true) ( 
// xuben: 循环 检查 事件 队列 ， 获 取 下 一 个 事件 
MonkeyEvent queuedEvent = commandQueue.getNextQueuedEvent () ; 
if (queuedEvent !- null) ( 
// dispatch the event 
return queuedEvent; 


l 

// xuben: 处 理 延 迟 MonkeyCommandReturn 

if (deferredReturn !- null) ( 
Log.d(TAG, "Waiting for event"); 
MonkeyCommandReturn ret = deferredReturn.waitForEvent (); 
deferredReturn - null; 
handleReturn (ret); 

} 

String command = input.readLine(); 

if (command == null) ( 
Log.d(TAG, "Connection dropped."); 
// Treat this exactly the same as if the user had 
// ended the session cleanly with a done commant. 
command = DONE; 


if (DONE.equals (command)) ( 

// xuben: 停止 server 以 便 接 收 新 的 连接 

try { 
stopServer(); 

} catch (IOException e) { 
Log.e(TAG, "Got IOException shutting down!", e); 
return null; 

} 


return new MonkeyNoopEvent (); 


// xuben: 若 收 到 退出 指令 则 退出 
if (QUIT.equals (command)) ( 
// then we're done 
Log.d(TAG, "Quit requested"); 
// let the host know the command ran OK 
returnOk(); 
return null; 
} 
if (command.startsWith("#")) { 
// keep going 
continue; 
l 
// xuben: i&ittranslateCommand() 对 指令 进行 翻译 
translateCommand (command); 
l 
} catch (IOException e) ( 
Log.e(TAG, "Exception: ", e); 
return null; 





通读 这 段 代码 ， 我 们 了 解 到 几 个 事情 。 








1) 首先 ， 通 过 startServer0 开 始 对 端口 进行 监听 。 


























2) 其 次 ， 通 过 循环 从 事件 队列 中 获取 下 一 个 事件 。 








3) 最 后 ， 通 过 translateCommand() 对 指令 进行 翻译 。 





Re 
全 那么， 指令 又 是 如 何 被 翻译 的 呢 ? 


继续 进入 translateCommand() 中 一 探究 竟 ， 如 代码 清单 8-30 所 示 。 





代码 清单 8-30 ”指令 翻译 





// xuben: 将 指令 翻译 为 MonkeyEvent 
private void translateCommand (String commandLine) { 
Log.d (TAG, "translateCommand: " + commandLine); 
// xuben: 将 指令 分 离 出 来 
List<String> parts = commandLineSplit (commandLine) ; 
if (parts.size() » O) ( 
// xuben: i&itCOMMAND MRP 将 指令 分 离 后 的 第 一 个 值 转换 
// 成 对 应 的 MonkeyCommand 
MonkeyCommand command = COMMAND MAP.get (parts.get (0)); 
if (command != null) ( 
// xuben: 通过 tranlsateCommand () 将 指令 翻译 为 
// 对 应 的 MonkeyEvent 
MonkeyCommandReturn ret = command.translateCommand (parts, 
commandQueue) ; 
// xuben: 将 对 应 MonkeyEvent 存 储 到 事件 队列 
handleReturn (ret); 





看 完 后 指令 翻译 方式 ， 我 们 大 致 清楚 以 下 内 容 。 


1) 首先 ， 分 离 指 令 的 第 一 部 分 (指令 主体 ) 。 





2) 其 次 ， 将 指令 转换 为 对 应 的 MonkeyCommand。 


3) 再 次 ， 通 过 tranlsateCommand() 方 法 将 对 应 的 MonkeyCommand 翻 译 为 对 应 的 MonkeyEvent。 

















4) 最 后 ， 将 对 应 MonkeyEvent 存 储 到 事件 队列 以 供 调 有 





A, 我 们 发 现 monkey 运 行 模式 的 一 些 奥妙 ， 是 时 


下 面 ， 我 们 将 进入 到 monke 


82.11 _monkey 运 行 核心 


到 这 里 ， 我 们 终于 进入 了 monkey 的 核心 位 置 : run() 方 法 根据 参数 从 不 同 的 对 


代码 清单 8-31 monkey.java::run() 第 五 段 代码 


候 回 到 run0 方 法 继续 探究 了 ! 


y 运 行 的 核心 runmonkeyCycles() 方 法 中 探秘 ! 


EB 





件 源 获 得 事件 并 放 入 到 EventQueue 后 ， 将 通过 循环 从 EventQueue 里 获取 如 





件 进行 执行 ， 如 代码 


8-31 所 示 。 





B4 





// xuben: 针对 各 种 运行 模式 对 mEventSource 进 行 验证 
// 每 种 模式 验证 方式 不 同 ， 感 兴趣 的 读者 可 逐一 进行 研究 
if (!mEventSource.validate()) { 

return -5; 


} 

// xuben: 在 monkey 运 行 前 生成 hprof 报 告 

if (mGenerateHprof) { 
signalPersistentProcesses(); 


l 

// xuben: 终于 ， 我 们 进入 到 了 monkey 整 个 运行 的 核心 ! 

// 通过 调用 monkeyNetworkMonitor.start() 开始 ， 调 用 

// monkeyNetworkMonitor .stop () 结束 。 中 间 运 行 了 什么 呢 ? 
// 没 错 ! 终极 BOSS 就 是 runmonkeyCycles () 这 个 函数 
mNetworkMonitor.start(); 


int crashedAtCycle - 0; 
try { 

crashedAtCycle = runMonkeyCycles(); 
) finally ( 


// xuben: 释放 rotation lock 
new MonkeyRotationEvent (Surface.ROTATION 0, fal 
mWm, mAm, mVerbose); 
} 
mNetworkMonitor.stop(); 


se) .injectEvent ( 





fer 
C XmonkeyNetworkMonitor Jf] F 3& 4 4+ A "6? 





$9... 于 监控 monkey 运 行 时 的 网 络 连接 (49 MOBILI 
小 插曲 6: monkey 终 极 BOSS 
下 面 ， 让 我 们 一 起 来 看 看 monkey 最 核心 的 代码 runmonk 


代码 清单 8-32 runmonkeyCycles() 


B, Wlf^F) 。 





极 BOSS 就 是 runmonkeyCycles() 这 个 函数 ， 还 等 什么 ， 直 取 黄 龙 吧 ! 


eyCycles() 这 个 方法 ， 如 代码 清单 8-32 所 示 。 





private int runMonkeyCycles () 
int eventCounter = 0; 
int cycleCounter - 0; 
boolean shouldReportAnrTraces - false; 
boolean shouldReportDumpsysMemInfo - false; 
boolean shouldAbort = false; 
boolean systemCrashed - false; 
// xuben: 


{ 


while (!systemCrashed && cycleCounter < mCount) 


synchronized (this) { 
if (mRequestProcRank) 
reportProcRank () ; 
mRequestProcRank = false; 


{ 


(mRequestAnrTraces) { 
mRequestAnrTraces false; 
shouldReportAnrTraces = true; 


(mRequestAnrBugreport) { 


通过 异步 操作 记录 一 些 运行 数据 ， 如 anr，appcrash，native crash 等 信息 


{ 


getBugreport ("anr_" + mReportProcessName + " "); 


mRequestAnrBugreport = false; 


(mRequestAppCrashBugreport) { 


getBugreport ("app crash" + mReportProcessName + " "); 
mRequestAppCrashBugreport - false; 


(mRequestPeriodicBugreport) { 
getBugreport ("Bugreport "); 
mRequestPeriodicBugreport - 


(mRequestDumpsysMemInfo) { 
mRequestDumpsysMemInfo false; 
shouldReportDumpsysMemInfo 


{ 
(checkNativeCrashes() && 
System.out.println("** New 
if (mRequestBugreport) { 


(mMonitorNativeCrashes) 
if 


(eventCounter > 0)) 


false; 


true; 


{ 


native crash detected."); 


getBugreport ("native_crash_"); 


mAbort = mAbort || 
} 

} 

if (mAbort) { 

shouldAbort = true; 


} 


} 

if (shouldReportAnrTraces) 
shouldReportAnrTraces 
reportAnrTraces () ; 


{ 
false; 


(shouldReportDumpsysMemInfo) 
shouldReportDumpsysMemInfo 
reportDumpsysMemInfo () ; 


{ 
false; 


(shouldAbort) { 
shouldAbort = false; 


!mIgnoreNativeCrashes || mKillProcessAfterError; 


System.out.println("** Monkey aborted due to error."); 


System.out.println("Events injected 
return eventCounter; 


: "+ eventCounter); 


l 
// xuben: 调试 模式 中 ， 通 过 长 延迟 以 便 手 动 操作 系统 
if (mSendNoEvents) ( 

eventCounter++; 

cycleCounter++; 


continue; 


l 

// xuben: 打印 时 间 和 发 送 事 件数 

if ((mVerbose > 0) && (eventCounter $ 100) == 0 && eventCounter != 0) ( 
String calendarTime = 


MonkeyUtils.toCalendarTime (System.currentTimeMillis ()) ; 
long systemUpTime = SystemClock.elapsedRealtime(); 
System.out.println("//[calendar time:" + calendarTime + " 


system uptime:" + systemUpTime + "]"); 
System.out.println("// Sending event #" + eventCounter); 


l 
// xuben: 核心 中 的 核心 : 先 通过 不 同 运行 模式 分 别 读 取 
// 下 一 事件 getNextEvent () 
MonkeyEvent ev = mEventSource.getNextEvent (); 
if (ev != null) { 
// xuben: 然后 通过 injectEvent () 将 事件 注入 到 系统 中 
int injectCode = ev.injectEvent (mWm, mAm, mVerbose); 
// xuben: 如 果 注 入 失败 ， 则 根据 不 同 操 作 分 别 记 录 Dropped-event 
if (injectCode == MonkeyEvent.INJECT FAIL) { 
if (ev instanceof MonkeyKeyEvent) { 
mDroppedKeyEventst+; 
} else if (ev instanceof MonkeyMotionEvent) { 
mDroppedPointerEvents++; 
} else if (ev instanceof MonkeyFlipEvent) { 
mDroppedFlipEvents++; 


} else if (ev instanceof MonkeyRotationEvent) { 
mDroppedRotationEvents++; 


// xuben: 如 果 注入 出 现 远程 异常 则 显示 远程 错误 
} else if (injectCode == 


MonkeyEvent.INJECT ERROR REMOTE EXCEPTION) { 
systemCrashed - true; 


System.err.println("** Error: RemoteException while injecting event."); 
// xuben: 如 果 注 入 出 现 安全 异常 则 显示 安全 错误 
} else if (injectCode == 

MonkeyEvent.INJECT ERROR SECURITY EXCEPTION) 


- = = { 
systemCrashed = !mIgnoreSecurityExceptions; 
if (systemCrashed) { 


System.err.println("** Error: SecurityException while injecting event."); 
} 


i 
// xuben: 记录 除 延迟 事件 外 的 事件 总 数 


if (!(ev instanceof MonkeyThrottleEvent)) { 
eventCounter++; 


if (mCountEvents) { 
cycleCounter++; 
} 


} 
// zuben: 事件 发 送 完毕 〈 即 没有 下 一 事件 产生 ) 后 ， 若 有 bugreport 
// 参数 则 捕获 bugreport 
} else ( 
if (!mCountEvents) { 
cycleCounter++; 
writeScriptLog (cycleCounter) ; 
// xuben: 捕获 bugreport 
if (mGetPeriodicBugreport) ( 
if ((cycleCounter $ mBugreportFrequency) 一 0) ( 
mRequestPeriodicBugreport - true; 


System.out.println("Events injected: " * eventCounter); 
return eventCounter; 








不 难 发 现 ， 其 实 真正 重 





的 就 这 两 句 ， 如 代码 清单 8-33 所 示 。 





代码 清单 8-33 


Jln} 





MAREA 


monkeyEvent ev = mEventSource.getNextEvent () ; 
if (ev != null) { 





int injectCode = ev.injectEvent (mWm, mAm, mVerbose); 





在 分 析 monkeySourceRandomScript.java 源 码 时 我 们 曾 一 起 看 过 monkeySourceRandom-Script 的 getNextEvent() 方 法 。 
不 过 它们 的 目的 都 只 有 一 个 ， 就 是 获取 下 一 个 事件 。 





























有 实 上 ， 针 对 不 同 运 行 模式 ，getNextEvent0 方 法 的 具体 实现 都 是 不 同 的 





而 获取 事件 后 最 需要 做 的 就 是 去 执行 相应 的 








a+, hie 





有 件 通 过 finjectEvent() 方 法 逐一 注入 到 系统 中 。 读 到 这 句 源码 ， 大 家 会 发 现 ， 实 现 finjectEvent0) 方 法 的 有 : MonkeyActivityEvent.java, 
MonkeyNoopEvent.java, MonkeyCommandEvent.java, MonkeyPowerEventjava, MonkeyRotationEvent.java, MonkeyFlipEvent.java, MonkeyThrottleEvent.java, 





MonkeyGetAppFrameRateEvent.java, MonkeyGetFrameRateEvent.java, MonkeylnstrumentationEvent.java, MonkeyWaitEvent.java, MonkeyKeyEvent.java#iMonkeyMotionEvent.java, 


生 ，finjectEvent() 拥 有 这 么 多 粉丝 啊 ! 


也 就 是 说 ， 不 同 的 对 





有 件 会 有 不 同 的 处 理 方式 : 有 的 仅 需 执行 几 条 命令 ， 另 一 些 则 需 




















调用 WindowManager 隐 藏 接 














做 事件 注入 等 ， 几 乎 每 个 Event 文 件 都 有 对 finjectEvent() 方 法 的 具体 


a 
B 


POr: command 模 式 。 


有 monkeyEvent 的 抽象 类 自 不 必 说 ， 那 monkeyTouchEvent 和 monkeyTrackballEvent 这 两 个 室 














需要 注意 的 是 ， 咱 们 这 里 之 所 以 说 “几乎 ”， 仔细 看 看 还 差 3 个 Event 文 件 没 实现 finjectEvent(): monkeyEventjava、monkeyTouchEventjava 和 monkeyTrackballEventjava。monkeyEvent 是 所 


要 文件 为 何 没有 实现 这 最 重要 的 一 步 呢 ? 








原因 很 简单 




















，monkeyTouchEvent 和 monkeyTrackballEvent 两 兄弟 并 没有 直接 继承 monkey-Event， 而 是 通过 继承 monkeyMotionEvent， 借 用 monkeyMeotionEvent 的 实现 来 实现 的 。 
至 于 每 个 文件 是 如 何 实现 这 个 核心 方法 的 ， 就 留 给 大 家 细 细 去 品味 了 ! 


8.2.12 ”旅程 结束 


run() 函 数 最 后 一 段 代 码 ， 如 代码 清单 8-34 所 示 。 
代码 清单 8-34 monkeyJjava::run() 第 六 段 代 码 


synchronized(this) ( 
if(mRequestAnrTraces) ( 
reportAnrTraces () ; 
mRequestAnrTraces = false; 





// xuben: 打印 an 报告 
if (mRequestAnrBugreport) { 


System.out.println("Print the anr report"); 
getBugreport ("anr " + mReportProcessName + " "); 


mRequestAnrBugreport - false; 


l 
// xuben: 打印 apP_crash 报 告 
if (mRequestAppCrashBugreport) ( 


getBugreport ("app crash" + mReportProcessName + " "); 


mRequestAppCrashBugreport - false; 
} 
if(mRequestDumpsysMemInfo) { 
reportDumpsysMemInfo(); 
mRequestDumpsysMemInfo = false; 


l 
if (mRequestPeriodicBugreport) { 
getBugreport ("Bugreport "); 


l 
// xuben: 在 monkey 运 行 后 再 次 生成 hprof 报 告 
if (mGenerateHprof) { 
signalPersistentProcesses(); 
if (mVerbose > 0) { 


System.out.println("// Generated profiling reports in /data/misc"); 


} 
} 
try { 
mAm.setActivityController (null); 
mNetworkMonitor.unregister (mAm); 
} catch (RemoteException e) { 


// just in case this was latent(after mCount cycles), make sure we report 


TE 


if(crashedAtCycle »- mCount) ( 
crashedAtCycle - mCount - 1; 
} 


} 
// xuben: 打印 dropped event stats 
if(mVerbose > 0) { 


System. 
System. 
System. 
System. 
System. 
System. 
System. 
System. 
System. 
System. 

} 

// xuben: 打印 network stats 
mNetworkMonitor.dump(); 


out.print 
out.print 


(":Dropped: keys-"); 
(mDroppedKeyEvents) ; 
out.print(" pointers-"); 
out.print (mDroppedPointerEvents) ; 
out.print(" trackballs=") ; 
out.print (mDroppedTrackballEvents); 
out.print(" flips-"); 
out. ( 
out 
out 


print (mDroppedFlipEvents); 
.print(" rotations-"); 
-println (mDroppedRotationEvents); 


if(crashedAtCycle « mCount - 1) ( 


System.err.println("** System appears to have crashed at event " + crashedAtCycle 
+" of " + mCount + " using seed " + mSeed); 
return crashedAtCycle; 
} else { 
if (mVerbose > 0) { 
System.out.println("// monkey finished"); 
} 


return 0; 





这 里 与 unmonkeyCycles() 方 法 中 的 异步 操作 类 似 一 一 通过 异步 操作 记录 一 些 运 行 数据 ， 如 anr、appcrash、DumpsysMeminfo 等 信息 。 



































这 里 需要 说 明 的 是 ， 若 你 想 在 ActivityController 中 调用 dumpsys call 会 造成 死 锁 ， 所 以 需要 在 monkey 的 主 循环 中 调用 它 。 
至 此 ， 我 们 从 run() 方 法 启程 ， 又 回 到 run() 方 法 里 画 下 句点 。 








8.3 monkey 的 原理 总 结 


OS s 


E] 
全 你 是 在 说 我 吗 ? 


错 ， 不 过 有 的 同学 估计 还 一 头 雾 水 呢 ! 


$99... 那 咱们 一 起 来 回顾 下 整个 旅程 吧 ! 


$o.,. 循环 取 事件 ; 





Monkey 运 行 的 根本 就 是 循环 取 事件 ， 这 是 通过 runMonkeyCyles() 方 法 进行 的 ， 既 然 循环 取 事 件 ， 就 需要 调用 getNextEvent() 方 法 来 取 下 一 个 事件 。 





Wera, 组 建 事件 队列 ; 





























既然 要 获得 下 一 个 导 





件 ， 就 需 


53 





AJI, AN 








> prenan 























体 导 





MonkeyEvent 又 通过 command 设 计 模式 将 : 


BO. ossnzart, 大 家 应 该 对 整个 流程 比较 清晰 了 ! 如 果 不 清 晰 的 可 以 回 到 对 应 章节 再 看 一 遍 ， 或 直接 打开 源码 自行 研究 。 


第 9 章 monkeyrunner 原 理 分 析 


9.1 





monkey 分 析 完 ， 看 他 儿子 就 容易 多 了 ! 


monkeyrunner 源 码 结构 


件 队列 就 是 MonkeyEventQueue， 而 事件 队列 MonkeyEventQueue 是 由 MonkeyEvent 构 成 的 。 


件 (如 MonkeyActivityEvent、Monkey-KeyEvent 和 MonkeyMotionEvent 等 ) 通 过 finjectEvent() 逐 一 注入 到 系统 中 。 


e» 
rT, BRAA A sre! 
好 的 ， 源 码 位 置 及 源码 树 如 下 所 示 。 

monkeyrunner 源 码 位 于 : “~\sdk\monkeyrunner\src\com\android\monkeyrunner” , 


其 源码 树 如 图 9-1 所 示 。 


rc 
findroid.mk 


om 

L—-andro id 

L—Tnonke yrunner 
JythonUtils.java 
MonkeyDevice. java 
MonkeyFormatter. java 
MonkeyI mage. java 
MonkeyRect. java 
MonkeyRunner. java 
Monke yRunnerte lp. java 
MonkeyRunnerOptions. java 
MonkeyRunnerStarter. java 


Monke wWiew. java 
Script Runner. java 


ontroller 
MonkeyController. java 
MonkeyControllerFrame. java 
VariableFrame. java 


oc 
Monke yRunnerExported. java 


asy 
By. java 
Eas yMonke yDevice. java 
README 


ecorder 
ActionListModel. java 
MonkeyRecorder. java 


IOLE nt ' ale «Aute 








actions 
fiction.java 
DragAction. java 
PressAction. java 
PyDictUtilBuilder. java 
Touchfction. java 
TypeAction. java 
WaitAction. java 


图 9-1 monkeyrunnerd #4 #} 


9.2 monkeyrunner 架 构 分 析 


全 % 比 其 父亲 复杂 多 了 ， 那 咱们 从 哪里 开始 呢 ? 


eo, 分 析 monkeyRunnet 源 码 前 ， 先 来 看 一 个 示例 脚本 。 


monkeyrunner 示 例 脚本 ， 如 代码 清单 9-1 所 示 。 





代码 清单 9-1 monkeyrunner 示 例 脚本 





import sys 

from com.android.monkeyrunner import monkeyrunner,monkeyDevice,monkeyImage 

# Connect to the current device 

device = monkeyrunner.waitForConnection () 

# Prepare settings component 

package = 'com.android.settings' 

activity = '.Settings' 

component = package + '/' + activity 

print 'Preparinghttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/...' 

# Install Settings.apk 

device.installPackage('./Settings.apk') 

print 'Install Settings.apkhttp: //www.hzcourse.com/resource/readBook?path=/openresources/teach_ebook/uncompressed/15501/OEBPS/Text/...' 
# Start settings activity 7 

device.startActivity (component) 

print 'Launch settinghttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/...' 
# Sleep 3s 

monkeyrunner.sleep (3.0) 

# Press Back 

device.press('KEYCODE BACK','DOWN AND UP') 

print 'Back to Menuhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/...' 
# Get the snapshot 

picture = device.takeSnapshot () 

print 'Take Snapshothttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/..." 
# save this picture 

picture.writeToFile('./bugben pic.png', 'png') 

print 'Complete! See bugben pic.png in current folder' 





详细 说 明 如 下 。 


1) 设备 连接 : 





device = monkeyrunner.waitForConnection () 














2) 应 用 安装 : 





device.installPackage('./Settings.apk') 














3) 应 用 启动 : 








device.startActivity (component) 





4) 按键 发 送 : 


device.press('KEYCODE BACK','DOWN AND UP') 





5) 截屏 : 








picture = device.takeSnapshot () 





6) 文件 存储 : 





picture.writeToFile('./bugben pic.png', 'png') 











d, ARYA AUR, RAR A AAA T Are! 











92.1 ”设备 连接 


首先 来 看 看 设备 连接 。 





device = monkeyrunner.waitForConnection () 





进入 monkeyDevice.java 查 看 waitForConnection() 方 法 ， 如 代码 清单 9-2 所 示 。 





代码 清单 9-2 monkeyDevice.java::waitForConnection() 





public static monkeyDevice waitForConnection(PyObject[] args, String[] kws) { 

// xuben: 获取 ArgParser 对 象 

ArgParser ap = JythonUtils.createArgParser (args, kws); 

// xuben: 检查 ArgParser 是 否 为 室 

Preconditions.checkNotNull (ap) ; 

long timeoutMs; 

try { 
double timeoutInSecs = JythonUtils.getFloat (ap, 0); 
timeoutMs =(long) (timeoutInSecs * 1000.0); 

} catch(PyException e) { 
timeoutMs = Long.MAX_VALUE; 


l 

// xuben: 获取 设备 device 

IChimpDevice device = chimpchat.waitForConnection (timeoutMs, 
ap.getString(1, ".*")); 

// xuben: 将 设备 传 给 monkeyDevice 对 象 

monkeyDevice chimpDevice = new monkeyDevice (device); 

return chimpDevice; 





具体 步骤 如 下 。 

1) 获取 ArgParser: 先 通过 JythonUtils.createArgParser() 获 取 ArgParser， 简 称 AP。 
2) 非 空 检 查 : 然后 通过 Preconditions.checkNotNull(ap) 检 查 其 是 否 为 空 。 

3) 获取 设备 : 再 通过 chimpchat.waitForConnection() 获 取 设 备 device。 

4) 创建 对 象 : 最 后 创建 monkeyDevice(device) 对 象 ， 将 设备 传 给 monkeyDevice。 


不 难 发 现 ， 真 正 关键 的 就 是 chimpchat.waitForConnection()， 这 也 是 monkeyrunner 的 核心 所 在 。 





<% 哦 ， 原 来 这 就 是 设备 连接 ， 这 个 Argparser 有 些 十 怪 ， 看 不 太 懂 。 
eo PREIS, ALARA AHA JythonUtils P RAEE! 
让 我 们 先进 入 JythonUtilsjava， 一 起 看 看 createArgParser() 方 法 。 
小 插曲 1: 解析 命令 行 参数 
打开 JythonUtils.java， 进 入 到 createArgParser() 方 法 ， 如 代码 清单 9-3 所 示 。 


代码 清单 9-3 JythonUtils.java::createArgParser() 





public static ArgParser createArgParser(PyObject[] args, String[] kws) ( 
StackTraceElement[] stackTrace = Thread.currentThread() .getStackTrace (); 
// xuben: StackTraceElement 数 组 中 第 二 个 元 素 即 是 当前 运行 的 函数 
StackTraceElement element = stackTrace[2]; 
// xuben: 获取 当前 运行 函数 的 方法 名 
String methodName = element .getMethodName () ; 
// xuben: 获取 当前 运行 函数 的 类 名 
String className = element.getClassName(); 
Class<?> clz; 





try { 
// xuben: 通过 类 名 查找 并 加 载 指定 的 类 
clz = Class.forName (className) ; 
} catch (ClassNotFoundException e) { 
LOG. log (Level.SEVERE, "Got exception: ", e); 
return null; 
$ 
Method m; 
try { 
// xuben: 通过 方法 名 查找 并 加 载 指定 的 方法 
m = clz.getMethod (methodName, PyObject[].class, String[].class); 
} catch(SecurityException e) ( 
LOG.log(Level.SEVERE, "Got exception: ", e); 
return null; 
} catch(NoSuchMethodException e) { 
LOG.log(Level.SEVERE, "Got exception: ", e); 
return null; 


l 

// xuben: 获取 annotation 

monkeyrunnerExported annotation = m.getAnnotation (monkeyrunnerExported.class); 
// xuben: 解析 命令 行 参数 

return new ArgParser (methodName, args, kws, annotation.args()); 





具体 步骤 如 下 。 


1) 获取 类 名 和 方法 名 : 从 当前 线程 中 获取 当前 运行 函数 的 类 名 和 方法 名 。 


N 


加 载 指 定 类 : 通过 Class.forName() 方 法 进行 类 名 查找 并 加 载 指定 的 类 。 


3) 加 载 指定 方法 : 通过 clz.getMethod() 方 法 进行 方法 名 查找 并 加 载 指定 的 方法 。 





4) 获取 annotation: 通过 getAnnotation() 方 法 获取 annotation。 


5) 解析 命令 行 参数 : 通过 ArgParser( 对 命令 行 参数 进行 解析 。 






BARRE, re MARU? 
B®. xen 的 重点 ， 感 兴趣 的 同学 自行 跟 进 吧 ， 咱 们 得 回 到 主题 继续 分 析 设备 连接 了 。 


小 插曲 2: 设备 连接 的 核心 
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ES 


接 下 来 咱们 看 什么 ? 


BO us ， 真 正 关键 的 是 chimpchat.waitForConnection0) 这 和 句 ， 到 chimpchat 看 看 吧 ! 


ChimpChat 源 码 位 于 “~\sdk\chimpchat\src\com\android\chimpchat” 文 件 夹 下 。 





IChimpDevice device = chimpchat.waitForConnection (timeoutMs, 
ap.getString(1, ".*")); 





跟踪 到 “~\sdk\chimpchat\src\com\android\chimpchat\ChimpChatjava” 中 ， 如 代码 清单 9-4 所 示 。 


代码 清单 9-4 ChimpChat.java::waitForConnection() 





// xuben: 从 backend 的 设备 实例 中 进行 检索 

public IChimpDevice waitForConnection(long timeoutMs, String deviceId){ 
return mBackend.waitForConnection (timeoutMs, deviceld); 

} 


继续 跟踪 到 “~/sdk/chimpchat/src/com/android/chimpchat/core/IChimpBackend.java”， 如 代码 清单 9-5 所 示 。 


代码 清单 9-5 IChimpBackend.java::waitForConnection() 





// xuben: 等 待 设备 连接 backend 
IChimpDevice waitForConnection(long timeoutMs, String deviceIdRegex) ; 








< 看 注释 都 看 尝 了 ! 我 就 想 知道 ， 究 竟 是 谁 实现 了 这 个 接口 ? 


eo, is. "841—383 — F XS Reo! 





不 查 不 知道 ， 一 查 吓 一 跳 : 原来 接口 在 AdbBackend 中 被 实现 “~/sdk/chimpchat/src/com/android/chimpchat/adb/AdbBackend.java”， 如 代码 清单 9-6 所 示 。 


代码 清单 9-6 AdbBackend.java::waitForConnection() 





GOverride 
public IChimpDevice waitForConnection(long timeoutMs, String deviceIdRegex) { 
do ( 
// xuben: 返回 匹配 设备 
IDevice device = findAttachedDevice (deviceIdRegex) ; 
// xuben: 只 返回 在 线 设备 
if(device != null && device.getState() == IDevice.DeviceState.ONLINE) { 
IChimpDevice chimpDevice = new AdbChimpDevice (device); 
devices.add (chimpDevice); 
return chimpDevice; 
} 
try { 
Thread. sleep (CONNECTION ITERATION TIMEOUT MS); 
} catch(InterruptedException e) { 
LOG.log(Level.SEVERE, "Error sleeping", e); 
} 
timeoutMs -= CONNECTION ITERATION TIMEOUT MS; 
} while(timeoutMs > 0); 
// Timeout. Give up. 
return null; 





让 我 们 先 来 看 看 findAttachedDevice()， 如 代码 清单 9-7 所 示 。 


代码 清单 9-7 findAttachedDevice() 





private IDevice findAttachedDevice (String deviceIdRegex) { 
// xuben: 创建 Pattern 对 象 并 传 入 deviceIdRegex 
Pattern pattern = Pattern.compile (deviceIdRegex); 
// xuben: iX *$,&, bridge 4 AndroidDebugBridge 
// 而 bridge.getDevices() 则 是 获取 设备 列表 的 重点 
for(IDevice device : bridge.getDevices()) { 
// xuben: i&itdevice.getSerialNunmber () 获取 设备 序列 号 
String serialNumber = device.getSerialNumber () ; 
// xuben: 如 果 该 设备 id 与 传 入 的 匹配 ， 则 返回 该 设备 
if (pattern.matcher (serialNumber) .matches()) { 
return device; 
} 
} 


return null; 





具体 步骤 如 下 。 


A 


创建 Pattern 对 象 : 通过 Pattern.compile() 方 法 创建 Pattern 对 象 并 传 入 deviceldRegex。 


2) 获取 设备 列表 : 通过 bridge.getDevices() 获 取 设 备 列表 。 








Ww 


取 设 备 序列 号 : 通过 device.getSerialINumber( 获 取 设 备 序列 号 。 





4) 返回 匹配 设备 : 如 果 该 设备 id 与 传 入 的 匹配 ， 则 返回 该 设备 。 





说 白 了 ， 就 是 “从 所 有 连接 设备 中 查找 设备 id 与 指定 正则 表达 式 匹配 的 设备 ”。 








Lh dede te! 获取 设备 列表 是 重点 。 


S9, ! 而 bridge 来 自 AndroidDebugBridge， 进 去 看 看 ! 








AndroidDebugBridge& "sdk/ddms/libs/ddmlib/src/com/android/ddmlib/AndroidDebug-Bridge.java" , W Rass: 














bridge.getDevices() 


跟踪 进去 ， 如 代码 清单 9-8 所 示 。 


代码 清单 9-8 bridge.getDevices() 





/** 
* Returns the devices. 
* @see #hasInitialDeviceList () 
x 
public IDevice[] getDevices() ( 
synchronized(sLock) ( 
// xuben: 通过 mDeviceMonitor 获 取 设 备 列 表 
if(mDeviceMonitor != null) ( 
return mDeviceMonitor.getDevices(); 
} 
} 
return new IDevice[0]; 


} 





mDeviceMonitor 为 DeviceMonitor 对 象 ， 而 mDeviceMonitor.getDevices() 方 法 则 来 自 “sdk/ddms/libs/ddmlib/src/com/android/ddmlib/DeviceMonitor.java”， 如 代码 清单 9-9 所 示 。 


代码 清单 9-9 DeviceMonitor.java::getDevices() 





// xuben: 返回 设备 
Device[] getDevices() { 
synchronized (mDevices) { 
return mDevices.toArray (new Device [mDevices.size()]); 


} 





B. ass: ， 就 是 Android 最 常用 命令 adb 的 缩写 。 


$2 





啊 ? 你 不 说 还 真 没 反应 过 来 ! 牛 啊 ! 
下 面 ， 让 我 们 一 起 来 领略 这 个 Android 世 界 的 王者 的 风采 吧 ! 
小 插曲 3: 获取 设备 三 步 
在 跟踪 到 AndroidDebugBridge.getDevices() 时 ， 注 释 中 的 一 句 话 (see#hasinitial-DeviceList0) 引起 了 我 的 注意 ， 如 代码 清单 9-10 所 示 。 


代码 清单 9-10 AndroidDebugBridge.getDevices() 





* Returns the devices. 
* @see #hasInitialDeviceList () 
sp 
public IDevice[] getDevices() { 
synchronized(sLock) { 
if(mDeviceMonitor != null) ( 
return mDeviceMonitor.getDevices (); 
} 
l 


return new IDevice[0]; 





这 里 指引 参考 hasinitialDeviceList0， 那 这 个 方法 又 会 给 我 们 带 来 什么 惊喜 呢 ? 如 代码 清单 9-11 所 示 。 





代码 清单 9-11  hasinitialDeviceList() 


/*** Returns whether the bridge has acquired the initial list from adb 

* after being created. <p/>Calling {@link #getDevices()} right after 

* {@link #createBridge (String, boolean)} will generally result in an empty 
list. This is due to the internal asynchronous communication 
mechanism with <code>adb</code> that does not guarantee that the {@link 
IDevice) list has been built before the call to {@link #getDevices()}. 
<p/>The recommended way to get the list of {@link IDevice} objects is 

* to create a {@link IDeviceChangeListener} object. 

* 

$ 
public boolean hasInitialDeviceList() { 

if (mDeviceMonitor != null) { 

return mDeviceMonitor.hasInitialDeviceList (); 
} 


return false; 


* 
* 
* 
* 





方法 很 简单 ， 就 是 返回 bridge 是 否 获得 初始 设备 列表 。 








多 
A 


AZIE, A ROS HONE KE IG M 80 0 — KIA TAT HE, MUS FUR HERD) PANELS 


$6... 这 正 是 人 家 严谨 过 人 之 处 。 这 段 注释 大 意 如 下 。 
代码 注释 解读 : 


4o X38 Jf createBridge(string boolean) 方法 后 直接 调用 getDevices0 方法 将 返回 一 个 空 设备 列表 。 这 是 因为 adqb 的 异步 通信 机 制 在 调用 getDevices(0 方 法 前 并 不 能 确保 设备 (IDevice) 列表 已 经 被 建 好 。 所 以 ， 建 
议 通过 创建 设备 监听 ( 即 IDevice-ChangeListener) 对 象 以 获取 设备 列表 。 


由 此 我 们 知道 ， 获 取 设 备 的 大 致 步骤 如 下 。 
1) 创建 adb: 通过 createBridge() 方 法 创建 AndroidDebugBridge 对 象 。 


2) 监听 设备 : 通过 IDeviceChangelListener 对 设备 进行 监听 。 


3) 获取 设备 列表 : 通过 getDevices() 方 法 获取 设备 列表 。 


下 面 ， 我 们 分 别 来 看 看 每 个 部 分 的 代码 吧 ! 








小 小 插曲 1: 创建 adb 








先 来 看 看 创建 adb， 即 通过 createBridge() 方 法 创建 AndroidDebugBridge 对 象 ， 如 代码 清单 9-12 所 示 。 


代码 清单 9-12 ”创建 adb 





public static AndroidDebugBridge createBridge() { 
synchronized(sLock) { 
if(sThis != null) ( 
return sThis; 


try { 
// xuben: 创建 AndroidDebugBridge (adb) 对 象 
sThis = new AndroidDebugBridge () ; 
// xuben: 启动 adb 
sThis.start (); 

} catch (InvalidParameterException e) { 
sThis = null; 


l 
// xuben: 当 应 用 程序 退出 时 常常 会 执行 事件 回调 ， 这 将 导致 监听 器 被 移 除 ， 
// 所 以 我 们 需要 在 此 保留 列表 副本 并 通过 远 代 替换 主 列表 
IDebugBridgeChangeListener[] listenersCopy = sBridgeListeners.toArray ( 
new IDebugBridgeChangeListener[sBridgeListeners.size()]); 
// xuben: 通知 监听 器 发 生 改 变 
for(IDebugBridgeChangeListener listener : listenersCopy) ( 
try ( 
listener.bridgeChanged (sThis); 
} catch(Exception e) { 
Log.e(DDMS, e); 
} 
} 


return sThis; 





具体 步骤 如 下 。 


1) 创建 adb 对 象 : 通过 new AndroidDebugBridge() 方 法 创建 AndroidDebugBridge 对 象 。 


N 


启动 adb: 通过 sThis.start() 方 法 启动 adb。 

















3) 保留 列表 副本 : 当 应 用 程序 退出 时 常常 会 执行 事件 回调 ， 这 将 导致 监听 器 被 移 除 ， 所 以 我 们 需要 在 此 保留 列表 副本 并 通过 迭代 蔡 换 主 列表 。 














4) 通知 监听 器 发 生 改变 : 通过 listener.bridgeChanged() 方 法 通知 监听 器 发 生 改 变 。 





里 最 重要 的 就 是 启动 db 了。 


EE EA UR! 


启动 adb 如 代码 清单 9-13 所 示 。 


代码 清单 9-13 ”启动 adb 





// xuben: 启动 adb 
boolean start() ( 
if (mAdbOsLocation != null &&(mVersionCheck == false || startAdb() == false)) { 
return false; 
} 
mStarted = true; 
// xuben: 创建 DeviceMonitor 对 象 ， 并 传 入 adbn 
mDeviceMonitor = new DeviceMonitor (this); 
// xuben: 启动 底层 服务 
mDeviceMonitor.start (); 
return true; 





< 哦 ， 原 来 是 通过 DeviceMonitor 启 动 的 。 


99... 继续 跟 进 ! 
DeviceMonitor 位 于 “~\sdk\ddms\libs\ddmlib\src\com\android\ddmlib\DeviceMonitorjava” 中 。 它 的 start() 方 法 如 代码 清单 9-14 所 示 。 


代码 清单 9-14  DeviceMonitor;java::start() 





// xuben: 启动 monitoring 
void start() { 
new Thread("Device List Monitor") { //$NON-NLS-1$ 
GOverride 
public void run() { 
deviceMonitorLoop () ; 
} 
).start(); 
} 











又 是 通过 调用 deviceMonitorLoop() 方 法 ， 再 进去 看 看 ， 如 代码 清单 9-15 所 示 。 











代码 清单 9-15 deviceMonitorLoop() 





private void deviceMonitorLoop() ( 
do ( 
try { 

if (mMainAdbConnection == null) { 
Log.d("DeviceMonitor", "Opening adb connection"); 
// xuben: iiiitopenAdbConnection () 建立 socket 连 接 
mMainAdbConnection = openAdbConnection () ; 

// xuben: 如 果 aqdb 的 主 连 接 (HpmMainAdbConnection) AÈ, 
// 通过 waitABit () 暂停 ls 
if(mMainAdbConnection == null) { 

mConnectionAttempt++; 


Log.e("DeviceMonitor", "Connection attempts: " + mConnectionAttempt); 
// xuben: 如 果 反 复 尝 试 10 次 后 adb 的 主 连 接 仍 为 空 ， 停 止 尝 试 
if(mConnectionAttempt > 10) ( 
// xuben: 若 此 时 通过 RndroidDebugBridge 的 startadb () 方法 重启 adb 
// 返回 false 则 将 adb 重 启 次 数 mRestartAttemptCount 加 1 后 记录 log 
if(mServer.startAdb() == false) ( 
mRestartAttemptCount++; 
Log.e ("DeviceMonitor", 
"adb restart attempts: " + mRestartAttemptCount) ; 
} else { 
mRestartAttemptCount = 0; 
} 
} 
// xuben: 通过 Thread.sleep (1000) 暂停 1s 


waitABit(); 
// xuben: 若 adb 的 主 连 接 不 为 空 ， 表 示 adb 连 接 成 功 
) else ( 


Log.d("DeviceMonitor", "Connected to adb for device monitoring"); 
mConnectionAttempt = 0; 
i } 
// xuben: 若 adb 的 主 连 接 不 为 空 但 mMonitoring 为 false， 
// 则 发 送 设 备 监视 请 求 
if(mMainAdbConnection != null && mMonitoring == false) ( 
mMonitoring = sendDeviceListMonitoringRequest () 7 


l 
// xuben: 若 mMonitoring 为 true， 表 示 设 备 信息 已 反馈 ， 
// 则 通过 readLength () 从 socket 读 取信 息 长 度 
if (mMonitoring) { 
// xuben: 获取 信息 长 度 
int length = readLength (mMainAdbConnection, mLengthBufer); 
// xuben: 获取 信息 长 度 大 于 0， 即 通过 processIncomingDeviceData() 对 
// socket 返 回 的 设备 信息 进行 处 理 ， 稍 后 进行 详 述 
if(length >= 0) ( 
// xuben: 信息 处 理 
processIncomingDeviceData (length); 
// xuben: 将 完成 设备 列表 创建 标志 设 为 Lrue， 表 示 至 少 成 功 完成 
// 过 1 次 设备 列表 创建 
mInitialDeviceListDone = true; 
} 
} 
} catch (AsynchronousCloseException ace) { 
// this happens because of a call to Quit. We do nothing, and the loop will break. 
} catch (TimeoutException ioe) { 
handleExpectioninMonitorLoop (ioe); 
} catch(IOException ioe) { 
handleExpectioninMonitorLoop (ioe) ; 
} 
} while(mQuit == false); 
} 





详细 说 明 如 下 。 


1) 创建 连接 : 首先 通过 openAdbConnection() 方 法 建立 socket 连 接 。 





2) 主 连接 为 空 : 

+ 如 果 adb 的 主 连接 (HpmmainAdbConnection) 为 空 ， 则 通过 waitABit0 方 法 暂停 1 秒 。 

“ 如 果 反 复 尝试 10 次 后 adb 的 主 连接 仍 为 空 ， 停止 尝试 。 

3) 主 连 接 非 空 : 若 adb 的 主 连接 不 为 空 ， 表 示 adb 连 接 成 功 。 

“ 若 adb 的 主 连接 不 为 空 但 mMonitorfing 为 false， 则 发 送 设 备 监 视 请 求 。 

. 若 mMonitorfing 为 true ， 表 示 设备 信息 已 反馈 ， 则 通过 readLength0 方 法 从 socket 读 取信 息 长 度 。 

@@ 获 取信 息 长 度 大 于 0， 即 通过 processfincomingDeviceData() 方 法 对 socket 返 回 的 设备 信息 进行 处 理 。 


@ 将 完成 设备 列表 创建 标志 设 为 true， 表 示 至 少 成 功 完 成 过 1 次 设备 列表 创建 。 


processfincomingDeviceData0 方 法 非常 可 疑 ， 我 怀疑 “四 十 二 章 经 ”应 该 就 藏 在 此 处 





接着 看 processfincomingDeviceData() 方 法 ， 发 现 挖 出 大 宝藏 了 ， 如 代码 清单 9-16 所 示 。 


代码 清单 9-16  processfincomingDeviceData() 





private void processIncomingDeviceData(int length) throws IOException { 
ArrayList<Device> list = new ArrayList<Device>(); 
if(length > 0) { 
byte[] bufer = new byte[length]; 
// xuben: 从 socket 读 取信 息 
String result = read(mMainAdbConnection, bufer); 
// xuben: 从 读 取 到 的 信息 中 分 离 出 所 有 设备 ，SNON-NLS-1$ 表 示 获 取 的 
// 第 一 个 字符 串 型 变量 是 一 个 标签 或 者 关键 字 ， 无 需 本 地 化 
String[] devices = result.split("\n"); //$NON-NLS-1$ 
// xuben: 从 所 有 设备 中 分 离 出 单个 设备 
for(String d : devices) { 
String[] param = d.split("\t"); //$NON-NLS-1$ 
if (param. length 2) 1 
// xuben: 获得 单个 设备 序列 号 
Device device = new Device(this, param[0] /*serialnumber*/, 
DeviceState.getState (param[1])) ; 
// xuben: 将 该 设备 添加 到 设备 列表 中 
list.add (device); 
} 
} 


l 

// xuben: i&itupdateDevices (list) 将 新 设备 列表 与 之 前 设备 列表 合并 
// 该 方法 将 在 讲解 通过 getDevices () 获取 设备 列表 时 详 述 
updateDevices (list); 








具体 步骤 如 下 。 


1) 读 取 信息 : 通过 read(mmainAdbConnection,bufer) 方 法 从 socket 中 读 取 相关 信息 。 





N 


获取 设备 : 


+ 从 读 取 到 的 信息 中 分 离 出 所 有 设备 。 


“ 从 所 有 设备 中 分 离 出 单个 设备 。 


“ 获得 单个 设备 序列 号 。 


3) 添加 列表 : 通过 list.add(device) 方 法 将 该 设备 添加 到 设备 列表 中 。 





4) 列表 合并 : 通过 updateDevices(list) 方 法 将 新 设备 列表 与 之 前 设备 列表 合并 。 
eo. 此 ， 通 过 createBridge(0 方 法 创建 ADB 对 象 已 经 清晰 了 ， 接 下 来 我 们 再 来 看 看 监听 设备 。 
小 小 插曲 2: 设备 监听 


监听 设备 ， 即 通过 IDeviceChangeListener 对 设备 进行 监听 ， 如 代码 清单 9-17 所 示 。 


代码 清单 9-17 设备 监听 


public interface IDeviceChangeListener { 
// xuben: 当 设 备 连接 时 发 送 监 听 
public void deviceConnected(IDevice device); 
// xuben: 当 设 备 断 开 连 接 时 发 送 监 听 
public void deviceDisconnected(IDevice device); 
// xuben: 当 设 备 数据 改变 时 发 送 监 听 
public void deviceChanged(IDevice device, int changeMask); 








我 只 想 说 ， 当 大 段 的 英文 注释 替换 为 一 句 中 文 时 ， 的 确 清晰 很 多 。 
$5,,.. 对 设备 连接 、 断 开 连 接 或 设备 数据 改变 进行 监听 。 当 设备 出 现 这 3 种 状态 时 都 将 通知 该 监听 器 。 
下 面 来 看 看 获取 设备 列表 ! 

小 小 插曲 3: 获取 设备 列表 


最 后 是 获取 设备 列表 ， 即 通过 getDevices() 方 法 获取 设备 列表 ， 如 代码 清单 9-18 所 示 。 





代码 清单 9-18 ”获取 设备 列表 getDevices() 





public IDevice[] getDevices() { 
synchronized(sLock) { 
if (mDeviceMonitor != null) ( 
// xuben: i&itmDeviceMonitor#ygetDevices () 方法 进行 获取 
return mDeviceMonitor.getDevices () ; 
J 
} 


return new IDevice[0]; 


又 是 通过 mDeviceMonitor.getDevices() 方 法 ， 再 次 进入 DeviceMonitor， 如 代码 清单 9-19 所 示 。 


代码 清单 9-19 DeviceMonitor.java::getDevices() 





Device[] getDevices() { 
synchronized (mDevices) { 
return mDevices.toArray (new Device [mDevices.size()]); 


} 





而 mDevices 则 是 一 个 设备 列表 。 看 到 这 里 ， 不 知道 大 家 反应 过 来 没有 ， 正 如 之 前 hasinitialDeviceList() 方 法 注释 所 言 ， 


好 。 所 以 ， 建 议 通 过 创建 设备 监听 ( 即 IDeviceChangeListener) 对 象 以 获取 设备 列表 。 


BO uran, 此 时 通过 getDevices0 方 法 拿 到 的 设备 列表 应 该 是 异步 创建 完成 后 的 设备 列表 。 





因为 adb 的 异步 通信 机 制 在 调 




















getDevices() 方 法 前 并 不 能 确保 设备 列表 已 经 被 建 


让 我 们 再 回 到 processfincomingDeviceData() 方 法 ， 当 时 我 们 遗留 了 最 后 一 个 方法 : updateDevices0。 现 在 ， 让 我 们 一 起 来 揭 开 它 神秘 的 面纱 ， 如 代码 清单 9-20 所 示 。 


代码 清单 9-20 updateDevices() 





private void updateDevices (ArrayList«Device» newList) ( 
// xuben: 通过 RndroidDebugBridge 锁 预先 锁定 ， 以 便 稍 后 
// mServer.deviceDisconnected 获 取 该 锁 
synchronized (AndroidDebugBridge.getLock()) { 
// xuben: 创建 devicesToQuery 列 表 以 便 后 续 进行 设备 信息 查询 
ArrayList<Device> devicesToQuery = new ArrayList<Device>(); 
synchronized(mDevices) { 
// xuben: 将 当前 设备 列表 中 的 每 一 个 设备 与 新 创建 的 设备 列表 进行 逐一 对 比 
// 对 比 完成 后 ， 新 设备 列表 中 的 设备 仍 未 被 监测 到 ， 我 们 将 通过 
// startMonitoringDevice () 对 其 进行 监测 
for(int d = 0 ; d < mDevices.size() ;) { 
Device device = mDevices.get (d); 
// xuben: 获取 新 设备 列表 大 小 
int count = newList.size(); 
boolean foundMatch - false; 
// xuben: 遍历 新 设备 列表 
for(int dd = 0 ; dd < count ; ddt+) ( 
Device newDevice - newList.get (dd); 
// xuben: 将 当前 设备 序列 号 与 新 列表 中 设备 ID 和 序列 号 进行 对 比 
if (newDevice.getSerialNumber () .equals (device.getSerialNumber())) ( 
foundMatch = true; 
// xuben: 若 新 列表 中 存在 该 设备 ， 判 断 其 状态 是 否 改变 
if(device.getState() != newDevice.getState()) ( 
// xuben: 若 该 设备 状态 发 生 改 变 ， 更 新 其 状态 
device.setState (newDevice.getState()); 
device.update (Device.CHANGE STATE); 
// xuben: 车 该 设备 目前 为 ready/online， 则 启动 监测 该 设备 





if(device.isOnline()) { 
if(AndroidDebugBridge.getClientSupport() == true) { 
// xuben: 若 启 动 监测 失败 ， 则 记录 log 
if(startMonitoringDevice (device) == false) ( 


Log.e ("DeviceMonitor", 
"Failed to start monitoring " 
+ device.getSerialNumber ()); 
i } 
// xuben: 若 设备 属性 计数 为 0， 则 将 其 加 入 到 devicesToQuery 列 表 ， 
// 以 便 后 续 进 行 设备 信息 查询 
if(device.getPropertyCount() == 0) { 


devicesToQuery.add (device); 
} 
} 
} 
// zuben: 若 该 设备 状态 未 发 生变 更 ， 则 将 其 从 新 设备 列表 中 移 除 
newList.remove (dd); 
break; 
} 
} 
if (foundMatch == false) { 
// xuben: 车 在 新 设备 列表 中 未 找到 该 设备 ， 我 们 将 从 
// 当前 设备 列表 中 将 该 设备 移 除 
removeDevice (device); 
mServer.deviceDisconnected (device); 
} eise { 
// xuben: 将 当前 索引 后 移 一 位 
det; 
} 
} 
// xuben: 将 新 设备 列表 中 剩余 设备 ( 即 当 前 设备 列表 中 未 包含 设备 ) 
// 添加 到 当前 设备 列表 中 
for (Device newDevice : newList) { 
mDevices.add (newDevice); 
mServer.deviceConnected (newDevice); 
// xuben: 启动 对 这 些 设备 的 监测 
if(AndroidDebugBridge.getClientSupport() == true) { 
if (newDevice.isOnline()) { 
startMonitoringDevice (newDevice) ; 
} 
$ 
// xuben: 若 这 些 新 设备 目前 为 Teady/online， 则 将 其 加 入 到 
// devicesToQuery 列 表 
if (newDevice.isOnline()) { 
devicesToQuery.add (newDevice); 
} 
} 


l 

// xuben: 查询 devicesToQuery 列 表 中 设备 信息 

for (Device d : devicesToQuery) { 
queryNewDeviceForInfo (d); 

} 


} 
// xuben: 清空 新 设备 列表 


newList.clear(); 





具体 步骤 如 下 。 


1) 预先 锁定 : 通过 AndroidDebugBridge 锁 预先 锁定 ， 以 便 稍 后 mServer.deviceDisconnected 获 取 该 锁 。 


N 





创建 列表 : 创建 devicesToQuery 列 表 ， 以 便 后 续 进 行 设备 信息 查询 。 





3) 逐 项 对 比 : 将 当前 设备 列表 中 的 每 一 个 设备 与 新 创建 的 设备 列表 逐一 进行 对 比 。 

“ 车 在 新 设备 列表 中 找到 该 设备 ， 将 更 新 其 设备 信息 (如 设备 状态 改变 等 ) 。 

“ 著 在 新 设备 列表 中 未 找到 该 设备 ， 将 从 当前 设备 列表 中 将 该 设备 移 除 。 

4) 启动 监测 : 对 比 完成 后 ， 新 设备 列表 中 的 设备 仍 未 被 监测 到 ， 我 们 将 通过 startMonitorfingDevice0 方 法 对 其 进行 监测 。 
5) 加 入 列表 : 若 这 些 新 设备 目前 为 ready/onlfine， 则 将 其 加 入 到 devicesToQuery 列 表 。 

6) 查询 信息 : 查询 devicesToQuery 列 表 中 设备 信息 。 

9o, 无 疑问 ， 这 段 代码 最 吸引 人 的 地 方 黄 过 于 启动 监测 该 设备 方法 startMonirtorfingDevice0。 

让 我 们 一 起 进入 startMonitorfingDevice() 方 法 中 看 个 究竟 吧 ， 如 代码 清单 9-21 所 示 。 


代码 清单 9-21 startMonitorfingDevice() 





Private boolean startMonitoringDevice (Device device) { 
// xuben: 通过 openAdbConnection() 打开 adb 连 接 
SocketChannel socketChannel = openAdbConnection(); 
if(socketChannel != null) { 
try { 
// xuben: 发 送 设 备 监测 请 求 
boolean result = sendDeviceMonitoringRequest (socketChannel, device); 
if(result) ( 
// xuben: 当选 择 器 为 空 ， 启 动 设备 监测 线程 ， 稍 后 详 述 
if(mSelector == null) ( 
startDeviceMonitorThread(); 
l 
// xuben: 传 入 socketChanne1 并 设置 客户 端 监测 socket 
device.setClientMonitoringSocket (socketChannel); 
synchronized (mDevices) { 
// xuben: 强制 阻塞 操作 立即 返回 ， 在 注册 选择 器 前 必须 调用 该 方法 
mSelector.wakeup(); 
// xuben: 调整 此 通道 的 阻塞 模式 ，false 为 非 阻塞 模式 
SocketChannel.configureBlocking (false); 
// xuben: 注册 该 选择 器 
socketChannel.register(mSelector, SelectionKey.OP READ, device); 
} 
return true; 
} 
} catch (TimeoutException e) { 
try { 
// attempt to close the socket if needed. 
SocketChannel.close(); 
) catch(IOException el) ( 
// we can ignore that one. It may already have been closed. 
} 
Log.d("DeviceMonitor", 
"Connection Failure when starting to monitor device '" 


+ device + "' : timeout"); 
} catch (AdbCommandRejectedException e) { 
try { 


// attempt to close the socket if needed. 
socketChannel.close() ; 
} catch(IOException el) { 
// we can ignore that one. It may already have been closed. 
} 
Log.d("DeviceMonitor", 
"Adb refused to start monitoring device '" 
+ device + "' : " + e.getMessage()); 
catch (IOException e) { 
try { 
// attempt to close the socket if needed. 
socketChannel .close() ; 
} catch(IOException el) { 
// we can ignore that one. It may already have been closed. 


Log.d("DeviceMonitor", 


"Connection Failure when starting to monitor device '" 
+ device + "' : " + e.getMessage ()) ; 
} 


return false; 


} 





具体 步骤 如 下 。 

1) 打开 adb 连 接 : 通过 openAdbConnection() 方 法 打开 adb 连 接 。 

2) 发 送 设备 监测 请 求 : 通过 sendDeviceMonitorfingRequest() 方 法 发 送 设备 监测 请 求 。 
3) 启动 设备 监测 线程 : 当选 择 器 为 空 ， 启 动 设备 监测 线程 。 


4) 监测 socket: 传 入 socketChannel 并 设置 客户 端 监测 socket。 








5) 阻塞 返回 : 强制 阻塞 操作 立即 返回 ， 在 注册 选择 器 前 必须 调用 该 方法 。 











6) 非 阻 塞 模式 : 调整 此 通道 的 阻塞 模式 ，false 为 非 阻塞 模式 。 
7) 注册 选择 器 : 通过 register() 方 法 注册 该 选择 器 。 
下 面 ， 我 们 来 看 看 启动 设备 监测 线程 (startDeviceMonitorThread()) 究竟 启动 了 什么 ， 如 代码 清单 9-22 所 示 。 


代码 清单 9-22 ”启动 设备 监测 线程 





private void startDeviceMonitorThread() throws IOException { 
// xuben: 通过 调用 系统 级 默认 SelectorProvider 对 象 的 openSelector () 
// 方法 来 创建 新 选择 器 
mSelector = Selector.open(); 
new Thread("Device Client Monitor") { //$NON-NLS-1$ 
GOverride 
public void run() { 
// xuben: 调用 循环 监测 客户 端 设备 
deviceClientMonitorLoop () ; 


} 
).start(); 
} 





下 面 来 查看 如 何 进行 循环 监测 客户 端 设 备 ， 如 代码 清单 9-23 所 示 。 


代码 清单 9-23 ”循环 监测 客户 端 设 备 





Private void deviceClientMonitorLoop() { 
do { 
try { 

// xuben: 异步 阻塞 可 以 阻止 添加 设备 时 调用 select () 
synchronized (mDevices) ( 

} 

int count = mSelector.select(); 

if(mQuit) ( 
return; 


l 
// xuben: mClientsToReopen'P $4 j£ 42 ii id addClientToDropAndReopen () 添加 的 
synchronized (mClientsToReopen) { 
if(mClientsToReopen.size() » 0) ( 
Set<Client> clients = mClientsToReopen.keySet () ; 
// xuben: 创建 监测 线程 
MonitorThread monitorThread = MonitorThread.getInstance () 7 
// xuben: client 代 表 一 个 客户 端 ， 通 常 为 DALVik 虚 拟 机 进程 
for(Client client : clients) ( 
// xuben: 获取 客户 端 设 备 
Device device = client.getDeviceImpl(); 
// xuben: 获取 pid 
int pid = client.getClientData() .getPid(); 
// xuben: 从 监测 线程 中 去 掉 该 客户 端 
monitorThread.dropClient(client, false /* notify */); 
// xuben: 等 待 1 秒 以 便 客户 端 对 二 次 握手 (second handshake) 做 出 回应 
waitABit (); 
// xuben: 获取 客户 端 端口 号 
int port = mClientsToReopen.get (client); 
// xuben: 若 该 端口 号 不 是 NO_STRATIC PORT， 则 获取 下 一 个 可 调试 端口 
if (port == IDebugPortProvider.NO STATIC PORT) { 
port = getNextDebuggerPort (); 
} 
Log.d("DeviceMonitor", "Reopening " + client); 
// xuben: 打开 客户 端 
openClient (device, pid, port, monitorThread) ; 
// xuben: 更 新 客户 端 列 表 
device.update (Device.CHANGE CLIENT LIST); 


mClientsToReopen.clear(); 
} 


l 
// xuben: 若 选择 器 数目 为 0， 则 从 藉 开 始 循环 
if(count == 0) ( 
continue; 
l 
// xuben: 获取 做 好 操作 准备 的 那些 选择 器 的 key 
Set«SelectionKey» keys = mSelector.selectedKeys () ; 
Iterator<SelectionKey> iter = keys.iterator(); 
// xuben: 遍历 这 些 key 
while (iter.hasNext()) ( 
SelectionKey key = iter.next(); 
iter.remove(); 
// xuben: 若 该 key 为 合法 且 可 读 的 ， 则 进入 
if(key.isValid() && key.isReadable()) { 
// xuben: ikX attachment 
Object attachment = key.attachment(); 
// xuben: 若 该 attachment 为 Device， 则 进入 
if(attachment instanceof Device) { 
Device device - (Device)attachment; 
// xuben: iüitgetClientMonitoringSocket () 获取 客户 端 监测 socket 
SocketChannel socket = device.getClientMonitoringSocket () ; 
if(socket != null) ( 
try { 
// xuben: 获取 该 socket 中 下 一 条 信息 的 长 度 
int length = readLength (socket, mLengthBufer2); 
// xuben: 接 下 来 是 个 很 重要 的 一 个 方法 : 
// 通过 对 socket 传 入 的 信息 (这 些 信息 即 为 符合 当前 设备 进程 
// 设置 的 pid) 与 该 设备 上 已 经 存在 的 客户 端 信息 作对 比 。 
// 删除 那些 pid 已 失效 的 客户 端 ， 并 为 新 客户 端 创建 pid 
processIncomingJdwpData (device, socket, length); 
catch(IOException ioe) ( 
Log.d("DeviceMonitor", 
"Error reading jdwp list: " + ioe.getMessage()); 
socket.close(); 
// xuben: i&itstartMonitoringDevice () 重启 对 设备 的 监测 
synchronized (mDevices) { 






if (mDevices.contains (device)) ( 
Log.d("DeviceMonitor", 
"Restarting monitoring service for " * device); 
startMonitoringDevice (device); 


l 

) catch(IOException e) ( 
if(mQuit == false) { 
} 


} 
} while (mQuit == false); 





具体 步骤 如 下 。 


Ll 


创建 监测 线程 : 通过 MonitorThread.getinstance() 方 法 创建 监测 线程 。 
2) 获取 客户 端 设 备 : 通过 client.getDevicelmpl() 方 法 获取 客户 端 设备 。 
3) 获取 pid: 通过 client.getClientData().getPid() 方 法 获取 pid。 


4) 从 监测 线程 中 去 掉 该 客户 端 : 通过 monitorThread.dropClient() 方 法 去 掉 客 户 端 。 











5) 获取 客户 端 端口 号 : 通过 mClientsToReopen.get() 方 法 获取 客户 端 端口 号 ， 若 该 端口 号 不 是 NO_STATIC_PORT， 则 获取 下 一 个 可 调试 端口 。 














6) 打开 客户 端 : 通过 openClient() 方 法 打开 客户 端 。 


7) 更 新 客户 端 列表 : 通过 device.update() 方 法 更 新 客户 端 列表 。 





8) 若 选 择 器 数目 为 0， 则 从 头 开始 循环 。 
9) 获取 做 好 操作 准备 的 那些 选择 器 的 key。 
10) 遍历 这 些 key: 
“ 车 该 key 为 合法 且 可 读 的 ， 则 进入 : 
Q@ 获 取 其 attachment。 
@ 若 该 attachment 为 Device， 则 进入 : 
+ 通过 getClientMonitorfingSocket0 方 法 获取 客户 端 监 测 socket。 
- 获取 该 socket 中 下 一 条 信息 的 长 度 。 


+ 通过 对 socket 传 入 的 信息 (这 些 信息 即 为 符合 当前 设备 进程 设置 的 pid) 与 该 设备 上 已 经 存在 的 客户 端 信息 作对 比 。 删 除 那些 pid 已 失效 的 客户 端 ， 并 为 新 客户 端 创建 pid。 





+ 通过 startMonitorfingDevice0 方 法 重启 对 设备 的 监测 。 





觉 不 爱 了 ， 不 要 烦 我 …… 
Ak atrttani: 
不 烦 你 ， 咱 们 去 看 看 应 用 安装 。 


92.2 ”应 用 安装 








在 示例 代码 里 ， 应 用 是 这 样 安装 到 设备 的 。 











device.installPackage('./Settings.apk') 





进入 到 monkeyDevice.java::installPackage()， 如 代码 清单 9-24 所 示 。 


代码 清单 9-24 ”应 用 安装 





public boolean installPackage (PyObject[] args, String[] kws) { 
// xuben: 获取 ap 
ArgParser ap = JythonUtils.createArgParser (args, kws); 
Preconditions.checkNotNull (ap) ; 
// xuben: 获取 安装 路 径 
String path = ap.getString(0); 
// xuben: 安装 应 用 
return impl.installPackage (path); 


具体 步骤 如 下 。 


1) 获取 ArgParser: 先 通过 JythonUtils.createArgParser() 方 法 获取 ArgParser， 简 称 AP。 


N 


非 空 检查 : 然后 通过 Preconditions.checkNotNull(ap) 方 法 检查 其 是 否 为 空 。 


3) 获取 安装 路 径 : 再 通过 ap.getstring(0) 方 法 获取 安装 路 径 ( 即 path) 。 








4) 应 用 安装 : 最 后 通过 impl.installPackage(path) 方 法 进行 安装 。 


B9... oss 的 感觉 ? 


E 





二 实 前 两 步 都 与 设备 连接 一 样 ， 获 取 ArgParser 前 面 已 经 分 析 过 。 


下 面 ， 让 我 们 直接 进入 到 核心 的 impl,installPackage(path) 方 法 看 个 究竟 吧 ! 


小 插曲 4: 安装 又 分 三 步 走 





IChimpDevice 对 installPackage 定 义 如 下 ， 如 代码 清单 9-25 所 示 。 


代码 清单 9-25 installPackage() 


// xuben: 安装 指定 package 
boolean installPackage (String path); 





实现 该 接口 的 是 AdbChimpDevice， 如 代码 清单 9-26 所 示 。 





代码 清单 9-26 AdbChimpDevice::installPackage() 





GOverride 
public boolean installPackage (String path) { 
try ( 
String result = device.installPackage (path, true); 
if(result != null) { 
LOG.log(Level.SEVERE, "Got error installing package: "+ result); 
return false; 
} 
return true; 
} catch(InstallException e) { 
LOG.log(Level.SEVERE, "Error installing package: " + path, e); 
return false; 
l 
} 





仍然 很 简单 ， 是 通过 device.installPackage() 方 法 进行 安装 ， 让 我 们 继续 跳 转 。 


再 次 进入 到 “sdk\ddms\libs\ddmlib\src\com\android\ddmlib\Devicejava” 中 ， 如 代码 清单 9-27 所 示 。 





代码 清单 9-27 Device.java::installPackage() 





GOverride 
public String installPackage (String packageFilePath, boolean reinstall, Stringhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEF 
extraArgs) 
throws InstallException ( 

try ( 
// xuben: 将 该 应 用 同步 到 设备 端 
String remoteFilePath = syncPackageToDevice (packageFilePath); 
// xuben: 安装 该 应 用 
String result installRemotePackage (remoteFilePath, reinstall, extraArgs); 
// xuben: 删除 该 应 用 在 设备 端的 拷贝 
removeRemotePackage (remoteFilePath); 
return result; 

} catch(IOException e) { 
throw new InstallException (e); 

} catch (AdbCommandRejectedException e) ( 
throw new InstallException (e); 

} catch(TimeoutException e) { 
throw new InstallException (e); 

} catch(SyncException e) { 
throw new InstallException (e); 














不 难 发 现 ， 安 装 应 用 又 分 为 下 面 3 步 。 




















1) 应 用 同步 : 先 通 过 syncPackageToDevice() 方 法 将 该 应 用 同步 到 设备 端 。 





2) 应 用 安装 : 然后 通过 installRemotePackage() 方 法 进行 安装 ; 

















3) 安装 包 删 除 : 最 后 通过 removeRemotePackage(0) 方 法 删除 该 应 用 在 设备 端的 拷贝 ( 印 磨 杀 驴 ) 。 
fe 

CU ARES A? 

| STPPP 用 同步 。 


小 小 插曲 1: 应 用 同步 








先 来 看 将 该 应 用 同步 到 设备 端的 syncPackageToDevice() 方 法 ， 如 代码 清单 9-28 所 示 。 








代码 清单 9-28 ”应 用 同步 到 设备 端 


GOverride 
public String syncPackageToDevice (String localFilePath) 
throws IOException, AdbCommandRejectedException, TimeoutException, SyncException ( 
SyncService sync - null; 
try { 
// xuben: 获取 应 用 路 径 
String packageFileName = getFileName (localFilePath); 
// xuben: 在 设备 端 为 该 应 用 指定 临时 目录 "/data/local/tmp/" 
String remoteFilePath = String.format ("/data/local/tmp/%1$s", packageFileName) ; 
Log.d(packageFileName, String.format("Uploading $1$s onto device '$2$s'", 
packageFileName, getSerialNumber ())); 
// xuben: 创建 同步 服务 ， 用 于 导入 /导出 设备 文件 Oppush/pull) 
// 车 该 服务 未 创建 成 功 则 返回 null 
sync = getSyncService(); 
if(sync != null) ( 
String message = String.format("Uploading file onto device '$1$s'", 
getSerialNumber()); 
Log.d(LOG TAG, message); 
// xuben: 将 应 用 同步 到 设备 的 临时 目录 中 
sync.pushFile(localFilePath, remoteFilePath, 
SyncService.getNullProgressMonitor()); 
) else ( 
throw new IOException ("Unable to open sync connection!"); 
} 
return remoteFilePath; 
} catch (TimeoutException e) { 
Log.e(LOG TAG, "Error during Sync: timeout."); 
throw e; ` 
} catch(SyncException e) { 
Log.e(LOG TAG, String.format("Error during Sync: %1$s", e.getMessage()); 
throw e; 


) catch(IOException e) { 
Log.e(LOG TAG, String.format("Error during Sync: $1$s", e.getMessage())); 
throw e; ` 
) finally ( 
if(sync != null) ( 
// xuben: 关闭 同步 服务 
sync.close(); 





具体 步骤 总 结 如 下 。 











1) 获取 应 用 路 径 : 通过 getFileName() 方 法 获取 应 用 路 径 ; 














2) 指定 临时 目录 : 在 设备 端 为 该 应 用 指定 临时 目录 "/data/local/tmp/" , 
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JARS: 通过 getSyncService() 方 法 创建 同步 服务 ， 这 是 关键 点 ， 感 兴趣 的 读者 可 以 深入 看 看 。 


all 























4) 应 用 同步 : 将 应 用 同步 到 设备 的 临时 目录 中 。 




















5) 关闭 同步 服务 : 通过 sync.close() 方 法 关闭 同步 服务 。 


T 


Se 


Loh, ARAB FMAM! 
$o.,. 大 致 如 此 ! 


小 小 插曲 2: 应 用 安装 








再 来 看 将 该 应 用 安装 到 设备 端的 installRemotePackage() 方 法 ， 如 代码 清单 9-29 所 示 。 














代码 清单 9-29 ”应 用 安装 到 设备 端 





GOverride 
public String installRemotePackage (String remoteFilePath, boolean reinstall, 


Stringhttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/... 


try ( 
Y // xuben: InstallReceiver 为 接收 运行 "pm install package.apk" 命 令 的 receiver 
InstallReceiver receiver = new InstallReceiver(); 
// xuben: 命令 参数 组 合 
StringBuilder optionString = new StringBuilder(); 
// xuben: 若 为 重 装 该 应 用 ， 则 需要 在 "Pm install "后 面 附 上 "-r "参数 
if(reinstall) ( 
optionString.append("-r "); 


l 
// xuben: 组 合 其 它 参 数 ， 目 前 仅 传 入 应 用 路 径 ， 所 以 没有 其 他 参数 ， 
// 也 无 需 附 "-r "参数 
for (String arg : extraArgs) { 
optionString.append (arg); 
optionString.append(' '); 


} 
// xuben: 将 组 合 的 参数 、 应 用 路 径 与 "pm install "命令 组 合 起 来 
String cmd = String.format("pm install %1$s\"%2$s\"", optionString.toString(), 
remoteFilePath); 
// xuben: i&itexecuteShellCommand|() 执行 该 命令 并 将 结果 放 入 receiver 中 保存 
executeShellCommand (cmd, receiver, INSTALL TIMEOUT); 
return receiver.getErrorMessage () ; B 
} catch(TimeoutException e) { 
throw new InstallException (e); 
} catch (AdbCommandRejectedException e) { 
throw new InstallException (e); 
} catch(ShellCommandUnresponsiveException e) { 
throw new InstallException (e); 
] catch(IOException e) ( 
throw new InstallException (e); 
} 


extraArgs) throws InstallException { 





具体 步骤 总 结 如 下 。 


1) 创建 InstallReceiver 对 象 : InstallReceiver 为 接收 运行 “pm install package.apk” 命 令 的 receiver。 





2) 命令 参数 组 合 如 下 。 

“ 若 为 重 装 该 应 用 ， 则 需要 在 “pm install” 后 面 附 上 “-r” 参 数 。 

“ 组 合 其 他 参数 ， 目 前 仅 传 入 应 用 路 径 ， 所 以 没有 其 他 参数 ， 也 无 需 附 “-r” 参 数 。 
“ 将 组 合 的 参数 、 应 用 路 径 与 “pm install ”命令 组 合 起 来 。 


3) 执行 命令 : 通过 executeshellCommand() 方 法 执行 该 命令 并 将 结果 放 入 receiver 中 保存 。 





这 个 执行 命令 的 executeShellCommand0 方 法 好 像 很 强大 ! 


9... 那 咱们 进去 看 看 ! 
executeShellCommand() 方 法 执行 该 命令 ， 如 代码 清单 9-30 所 示 。 


代码 清单 9-30 ”执行 命令 





GOverride 
public void executeShellCommand (String command, IShellOutputReceiver receiver, 
int maxTimeToOutputResponse) 
throws TimeoutException, AdbCommandRejectedException, 
ShellCommandUnresponsiveException, 
IOException { 
AdbHelper .executeRemoteCommand (AndroidDebugBridge.getSocketAddress () 
, command, this, receiver, maxTimeToOutputResponse) ; 





通过 AdbHelper.executeRemoteCommand() 方 法 进行 命令 发 送 ， 我 们 重点 关注 command 是 如 何 处 理 的 ， 如 代码 清单 9-31 所 示 。 








代码 清单 9-31 AdbHelperjava::executeRemoteCommand() 





// xuben: 执行 she11 命 令 并 将 结果 传 给 参数 FTCVT 
static void executeRemoteCommand (InetSocketAddress adbSockAddr, 
String command, IDevice device, IShellOutputReceiver rcvr, int 
maxTimeToOutputResponse) 
throws TimeoutException, AdbCommandRejectedException, 
ShellCommandUnresponsiveException, 
IOException { 
Log.v("ddms", "execute: running " + command); 
SocketChannel adbChan - null; 
try ( 
// xuben: 创建 adb channe1 并 连接 socket 
adbChan = SocketChannel.open (adbSockAddr) ; 
// xuben: 为 该 channe1 设 置 阻塞 模式 ，false 为 非 阻 塞 模 式 
adbChan.configureBlocking (false); 
// xuben: 告知 adb 与 指定 设备 对 话 ， 若 该 设备 不 为 -1， 
// 则 提醒 adb 需 要 与 指定 设备 对 话 
setDevice (adbChan, device); 
// xuben: 在 命令 前 加 上 "shell" 并 转换 为 以 4 个 16 进 制 数 开头 的 ASCII 字 符 串 
byte[] request = formAdbRequest ("shell:" + command); //$NON-NLS-1$ 
// xuben: 将 转换 后 的 命令 写 入 adb channel， 相 当 于 命令 执行 
write(adbChan, request); 
// xuben: 读 取 执行 adb 命 令 后 的 返回 结果 ， 相 当 于 命令 返回 
// readAdbResponse () 里 面 的 while 用 得 插 有 意思 ， 感 兴趣 的 读者 可 以 进去 看 看 
AdbResponse resp = readAdbResponse(adbChan, false /* readDiagString */); 
if(resp.okay -- false) ( 
Log.e("ddms", "ADB rejected shell command(" + command + "): "+ 
resp.message) ; 
throw new AdbCommandRejectedException (resp.message) ; 


} 
// xuben: 设置 用 于 存储 adb channel 信 息 的 buf 
byte[] data = new byte[16384]; 
ByteBufer buf = ByteBufer.wrap (data); 
int timeToResponseCount - 0; 
while(true) ( 

int count; 


// xuben: 若 用 于 接收 结果 的 参数 rcvr 不 为 空 或 cancel1 了 ， 则 跳出 循环 


if(rcvr != null && rcvr.isCancelled()) ( 
Log.v("ddms", "execute: cancelled"); 
break; 


l 
// xuben: 将 adb channel 信 息 存储 在 buf 中 并 将 实际 读 取 到 的 
// 字 节 数 返回 给 count 
count = adbChan.read (buf); 
// xuben: 若 字 节 数 小 于 0， 则 通过 flush () 清空 输出 并 跳出 循环 
if(count < 0) ( 

rcvr.flush(); 


Log.v("ddms", "execute '" + command + "' on '" + device + "' : EOF hit. Read: " 
* count); 
break; 
// xuben: 若 字 节 数 等 于 0， 则 等 待 
) else if(count == 0) ( 
try { 


int wait = WAIT_TIME * 5; 
timeToResponseCount += wait; 
if (maxTimeToOutputResponse > 0 && 
timeToResponseCount > maxTimeToOutputResponse) { 
throw new ShellCommandUnresponsiveException () ; 


} 
Thread.sleep (wait) ; 
} catch (InterruptedException ie) ( 


l 
// xuben: 若 字 节 数 大 于 0， 则 将 data 传 给 receiver 
) else ( 
// xuben: 重 置 反应 时 间 
timeToResponseCount = 0; 
// xuben: 将 data 传 给 receiver (Wprcvr) 
if(rcvr != null) { 
rcvr.addOutput (buf.array(), buf.arrayOfset(), buf.position()); 


准备 为 数据 传 出 状态 
感 兴趣 的 读者 可 扩展 阅读 


l 
// xuben: buf 的 写 操作 完成 后 ， 通 过 rewind() 方法 将 缓冲 
// 与 f1ip() 方 法 不 同 ，rewind() 方 法 不 会 修改 限制 位 置 ， 
buf.rewind(); 
} 
} 
} finally { 
// xuben: 关闭 adb channel 
if(adbChan != null) ( 
adbChan.close(); 








Log.v("ddms", "execute: returning"); 





具体 步骤 总 结 如 下 。 


1) 组 合 命令 : 将 命令 组 合 为 “pm install[-r[parameters] «package.apk»" , 





2) 执行 命令 : 通过 executeShellCommand0 方 法 执行 该 命令 并 将 结果 放 入 receiver 中 保存 。 
+ 创建 adb channel 并 连接 socket。 

“ 将 该 channel 设 置 为 非 阻塞 模式 。 

“ 告知 adb 与 指定 设备 对 话 。 

“ 在 命令 前 加 上 “shell” 并 转换 为 ASCII 字 符 串 。 

+ 通过 将 转换 后 的 命令 写 入 adb channel 的 方式 执行 命令 。 

“ 通过 读 取 执 行 adb 命 令 后 的 返回 结果 的 方式 获取 命令 返回 。 

- 将 data 传 给 receiver ( 即 tcvt) o 


+ 关闭 adb channel. 






原来 还 是 通过 adb shell 进 行 运行 的 ! 
eo... adb shell 是 Android 命 令 运行 的 基础 。 


小 小 插曲 3: 应 用 删除 

















最 后 来 看 将 设备 端 应 用 删除 的 removeRemotePackage() 方 法 ， 如 代码 清单 9-32 所 示 。 











代码 清单 9-32 ”设备 端 应 用 删除 





GOverride 


public void removeRemotePackage (String remoteFilePath) throws InstallException ( 
try { 
Teete itomena ("zm " + remoteFilePath, new NullOutputReceiver(), INSTALL TIMEOUT); 
] catch(IOException e) ( 
throw new InstallException (e); 
} catch(TimeoutException e) { 
throw new InstallException (e); 
} catch (AdbCommandRejectedException e) ( 
throw new InstallException (e); 
} catch(ShellCommandUnresponsiveException e) { 
throw new InstallException (e); 





大 致 步骤 总 结 如 下 。 
1) BERS: 将 命令 组 合 为 “rm<remotefilePath>”。 
2) 执行 命令 : 通过 executeShellCommand() 方 法 执行 该 命令 并 将 结果 放 入 receiver 中 保存 。 


不 难 发 现 ， 这 次 同样 是 通过 AdbHelper.executeRemoteCommand() 方 法 进行 命令 执行 ， 只 不 过 这 次 命令 换 成 了 “rm<remotefilePath>” 。 














体 执行 步骤 参见 “9.2.2 应 用 安装 ”一 节 。 











se 
Eg 


一 哈哈， 原理 一 样 ， 理 解 起 来 就 容易 了 。 





是 的 ， 熟 能 生 巧 就 是 这 个 道理 。 


9.2.3 ”应 用 启动 








应 用 启动 ， 如 下 。 











device.startActivity (component) 





进入 到 monkeyDevice.java::startActivity()， 如 代码 清单 9-33 所 示 。 


代码 清单 9-33 monkeyDevice.java::startActivity() 





public void startActivity (PyObject[] args, String[] kws) { 
ArgParser ap = JythonUtils.createArgParser (args, kws); 
Preconditions.checkNotNull (ap) ; 
String uri - ap.getString(0, null); 
String action = ap.getString(1, null); 
String data - ap.getString(2, null); 
String mimetype = ap.getString(3, null); 
Collection<String> categories = Collections2.transform(JythonUtils.getList(ap, 4), 
Functions.toStringFunction()); 
Map<String, Object» extras = JythonUtils.getMap(ap, 5); 
String component - ap.getString(6, null); 
int flags = ap.getInt(7, 0); 
impl.startActivity(uri, action, data, mimetype, categories, extras, component, flags); 





实现 该 接口 的 同样 是 AdbChimpDevice， 如 代码 清单 9-34 所 示 。 





代码 清单 9-34  startActivity() 





GOverride 
public void startActivity(String uri, String action, String data, String mimetype, 
Collection<String> categories, Map«String, Object» extras, String component, 
int flags) ( 
List«String» intentArgs - buildIntentArgString(uri, action, data, mimetype, 
categories, extras, component, flags); 
shell(Lists.asList("am", "start", 
intentArgs.toArray (ZERO LENGTH STRING ARRAY)).toArray( 
ZERO LENGTH STRING ARRAY)); 





再 来 看 shell， 如 代码 清单 9-35 所 示 。 


代码 清单 9-35 shell0 





private String shell (Stringhttp://www.hzcourse.com/resource/readBook?path=/openresources/teach ebook/uncompressed/15501/OEBPS/Text/... args) { 
StringBuilder cmd = new StringBuilder(); = 
for (String arg : args) { 
cmd.append (arg) .append(" "); 


return shell (cmd.toString()); 








命令 转 给 重 载 的 shell() 方 法 执行 ， 如 代码 清单 9-36 所 示 。 





代码 清单 9-36 shell) 





GOverride 
public String shell(String cmd) ( 

CommandOutputCapture capture = new CommandOutputCapture (); 

tty ( 
device .executeShellCommand (cmd, capture); 

} catch(TimeoutException e) { 

LOG.log(Level.SEVERE, "Error executing command: " + cmd, e); 
return null; 

} catch(ShellCommandUnresponsiveException e) ( 
LOG.log(Level.SEVERE, "Error executing command: " + cmd, e); 
return null; 

} catch (AdbCommandRejectedException e) { 

LOG.log(Level.SEVERE, "Error executing command: " + cmd, e); 
return null; 

} catch(IOException e) { 

LOG.log(Level.SEVERE, "Error executing command: " + cmd, e); 
return null; 

} 


return capture.toString(); 











应 用 安装 大 致 步骤 总 结 如 下 。 








1) 组 合 命令 : 将 命令 组 合 为 “am start«component»" ， 从 运行 脚本 我 们 知道 ， 这 个 component 由 package 和 activity 组 合 而 成 ， 如 “com.android.settings/.Settings”。 

















2) 执行 命令 : 通过 executeShellCommand0) 方 法 执行 该 命令 并 将 结果 放 入 capture 中 保存 (具体 步骤 参见 上 一 节 ) 。 








全 想不到 应 用 启动 也 是 通过 这 个 方法 ， 我 还 以 为 都 是 从 界面 启动 呢 ! 
959... ons. 直观 、 有 效 ， 各 有 所 长 吧 ! 


924 ”按键 发 送 


下 面 来 看 看 按键 发 送 ， 如 下 。 





device.press('KEYCODE BACK','DOWN AND UP") 





进入 到 monkeyDevice.java::press()， 如 代码 清单 9-37 所 示 。 


代码 清单 9-37  monkeyDevice java::press() 





GmonkeyrunnerExported (doc = "Send a key event to the specified key", 
args = ( "name", "type" }, 
argDocs = ( "the keycode of the key to press (see android.view.KeyEvent)", 
"touch event type as returned by TouchPressType(). To simulate typing a key, " * 
"send DOWN AND UP"]) 
public void press(PyObject[] args, String[] kws) ( 

ArgParser ap = JythonUtils.createArgParser (args, kws); 

Preconditions.checkNotNull (ap) ; 

String name - ap.getString(0); 

String touchType - ap.getString(1, DOWN AND UP); 

if(touchType.equals ("DOWN AND UP"))( ` 7 
touchType = "downAndUp"; 


l 

// xuben: 将 传 入 按键 类 型 转换 为 适 配 类 型 

TouchPressType type = TouchPressType.fromIdentifier (touchType) ; 
// xuben: 传 入 到 RdbChimpDevice 中 

impl.press (name, type); 








eo 简单 地 说 ， 就 是 根据 不 同 的 按 下 类 型 来 调用 ChimpManaget 中 不 同 的 press 的 方法 。 


实现 该 接口 的 同样 是 AdbChimpDevice， 如 代码 清单 9-38 所 示 。 





代码 清单 9-38 press() 





QOverride 
public void press (String keyName, TouchPressType type) { 
try { 
// xuben: 通过 type 进 行 区 分 
switch(type) ( 
case DOWN AND UP: 
manager.press (keyName) ; 
break; 
case DOWN: 
manager.keyDown (keyName) ; 
break; 
case UP: 
manager.keyUp (keyName) ; 
break; 
+ 
} catch(IOException e) { 
LOG.log(Level.SEVERE, "Error sending press event: " + keyName + " " + type, e); 
l 
} 
GOverride 
public void press(PhysicalButton key, TouchPressType type) ( 
press (key.getKeyName(), type); 








(这 又 是 什么 呀 ? 


DS os stone 简单 区 分 后 ， 通 过 managet 进 行 按键 发 送 。 








这 里 的 manager 即 为 ChimpManager 的 实例 对 象 ， 且 在 AdbChimpDevice 构 造 函 数 中 对 其 进行 处 理 ， 如 代码 清单 9-39 所 示 。 


代码 清单 9-39 AdbChimpDevice() 





public AdbChimpDevice (IDevice device) ( 
this.device = device; 
// xuben: 这 是 重点 ， 后 续 将 详 述 
this.manager = createManager ("127.0.0.1", 12345); 
Preconditions.checkNotNull (this.manager); 

} 





下 面 进入 AdbChimpDevice 看 看 press0、keydown(0 和 keyup0， 如 代码 清单 9-40 所 示 。 


代码 清单 9-40 ”press0、keydown(0 和 keyup0 





// xuben: 按键 发 送 
public boolean press(String name) throws IOException ( 
return sendmonkeyEvent ("press " + name); 


l 

// xuben: 按 下 按键 

public boolean keyDown(String name) throws IOException { 
return sendmonkeyEvent ("key down " + name); 


l 
// xuben: 抬 起 按键 
public boolean keyUp(String name) throws IOException { 


return sendmonkeyEvent ("key up " * name); 


} 





上 述 3 个 方法 都 是 通过 sendmonkeyEvent( 方 法 进行 处 理 的 ， 进 去 看 看 ， 如 代码 清单 9-41 所 示 。 





代码 清单 9-41 sendmonkeyEvent() 





private boolean sendmonkeyEvent (String command) throws IOException { 
synchronized(this) ( 
String monkeyResponse - sendmonkeyEventAndGetResponse (command) ; 
return parseResponseForSuccess (monkeyResponse); 
} 
} 





又 是 通过 sendmonkeyEventAndGetResponse() 方 法 进行 处 理 ， 继 续 进入 ， 如 代码 清单 9-42 所 示 。 


代码 清单 9-42 sendmonkeyEventAndGetResponse() 





private String sendmonkeyEventAndGetResponse (String command) throws IOException { 
command = command.trim(); 
LOG.info("monkey Command: " + command + "."); 
// xuben: 发 送 命令 并 接收 反馈 
monkeyWriter.write (command + "\n"); 
monkeyWriter.flush(); 
return monkeyReader.readLline|(); 


通过 monkeyWriter 传 入 命令 ， 通 过 monkeyReader 获 取 返 回 ， 如 代码 清单 9-43 所 示 。 





代码 清单 9-43 ChimpManager() 





private Socket monkeySocket; 
private BuferedWriter monkeyWriter; 
private BuferedReader monkeyReader; 
public ChimpManager (Socket monkeySocket) throws IOException { 
this.monkeySocket = monkeySocket; 
monkeyWriter = 
new BuferedWriter (new OutputStreamWriter (monkeySocket.getOutputStream())); 
monkeyReader = new(new InputStreamReader (monkeySocket.getInputStream())); 





上 述 代码 是 通过 BuferedWriter 和 BuferedReader 操 作 monkeySocket 这 个 Socket 的 〈 即 发 送 命令 和 获取 返回 值 ) 。 





回 





这 个 monkeySocket 又 是 在 哪里 传 入 的 呢 ? 


B uoo 造 函 数 中 对 managet 的 初始 化 。 





在 AdbChimpDevice 构 造 函数 中 对 manager 的 初始 化 createManager("127.0.0.1",12345)， 即 传 入 地 址 为 “127.0.0.1”， 而 端 


下 面 让 我 们 一 起 来 看 看 createManager( 方 法 ， 如 代码 清单 9-44 所 示 。 





代码 清单 9-44 createManager() 











为 12345。 





private ChimpManager createManager (String address, int port) { 

try { 
// xuben: 通过 调用 ddmlib 的 device 类 中 的 createForward () 方法 将 PC 端 
// 的 端口 转发 给 monkey 监 听 端 口 
device.createForward (port, port); 

} catch (TimeoutException e) { 
LOG.log(Level.SEVERE, "Timeout creating adb port forwarding", e); 
return null; 

} catch (AdbCommandRejectedException e) { 
LOG. log (Level.SEVERE, "Adb rejected adb port forwarding command: " + 

e.getMessage(), e); 

return null; 

} catch(IOException e) { 
LOG. log (Level.SEVERE, "Unable to create adb port forwarding: " + e.getMessage(), e); 
return null; 


l 
// xuben: 调用 executeRAsyncCommand () 方法 发 送 异步 adb shell¢r4 "monkey - port" 
// 到 手机 端 开 启 monkey 并 监听 端口 
String command = "monkey --port " + port; 
executeAsyncCommand (command, new LoggingOutputReceiver (LOG, Level.FINE)); 
// Sleep for a second to give the command time to execute. 
try { 
Thread. sleep (1000); 
} catch(InterruptedException e) { 
LOG.log(Level.SEVERE, "Unable to sleep", e); 
f 
InetAddress addr; 
try { 
addr - InetAddress.getByName (address); 
} catch(UnknownHostException e) { 
LOG.log(Level.SEVERE, "Unable to convert address into InetAddress: " + address, e); 
return null; 
} 
boolean success = false; 
ChimpManager mm = 
long start = System.currentTimeMillis () ; 
while(!success) ( 
long now = System.currentTimeMillis(); 
long dif - now - start; 
if(dif > MANAGER CREATE TIMEOUT MS) { 
LOG.severe("Timeout while trying to create chimp mananger"); 
return null; 
} 
try { 
Thread.sleep (MANAGER CREATE WAIT TIME MS); 
) catch(InterruptedException e) ( 
LOG.log(Level.SEVERE, "Unable to sleep", e); 
$ 
Socket monkeySocket; 
try { 
// xuben: monkeySocket 就 是 在 这 里 确定 的 了 ! 
monkeySocket = new Socket (addr, port); 
catch (IOException e) { 
LOG. log (Level .FINE, "Unable to connect socket", e); 
success = false; 
continue; 
} 
try { 
// xuben: 就 是 在 这 里 将 monkeySocket 传 给 ChimpManager 的 ! 
mm = new ChimpManager (monkeySocket) ; 
) catch(IOException e) ( 


LOG. log (Level . SEVERE, 


"Unable to open writer and reader to 


continue; 


} 


try { 
mm.wake(); 
) catch(IOException e) ( 


LOG.log (Level.FINE, 
success = 


"Unable to wake up device", e); 
false; 


continue; 


} 


success = true; 


} 


return mm; 


} 


按键 发 送 大 致 步骤 总 结 如 下 。 














4) 





1) 端口 转发 : 通过 调 


3) 创建 monkeySocket: 创建 连接 到 PC 端的 手机 端 monkey 监 听 端 口 


5) 确定 调 

















: 调 











ddmlib 的 device 类 中 的 createForward() 方 法 将 PC 端 本 地 的 端口 转发 给 monkey 监 听 端 


executeAsyncCommand() 方 法 发 送 异步 adb shell 命 令 “monkey-port” 到 手机 端 开启 monkey 并 监听 端 

















类 型 : 通过 按键 类 型 (DOWN, UP. DOWN AND UP) 确定 调 有 











- DOWN AND UP: 调用 manager.press(keyName)。 


: DOWN: +J} manager.keyDown(keyName) » 


- UP: 38 manager.keyUp(keyName) o 


6) 执行 命令 : 通过 sendmonkeyEvent() 方 法 执行 命令 。 


: DOWN AND UP: sendmonkeyEvent("press"+name)。 


- DOWN: sendmonkeyEvent("key down"--name) o 


- UP: sendmonkeyEvent("key up"+name) 。 


9) 

















TOW! 很 清晰 ! 


9.25 截屏 











下 面 是 截 





代码 。 








picture = device.takeSnapshot () 


Socket"); 




















(如 此 一 来 即 可 通过 PC 端的 转发 端 

















的 monkeySocket。 





构建 ChimpManager: 通过 createManager() 方 法 来 构造 nonkeySocket 并 将 其 传 给 ChimpManager。 


ChimpManager 对 应 函数 。 


31: sendmonkeyEvent() 方 法 通过 sendmonkeyEventAndGetResponse() 方 法 来 执行 命令 。 
用 2: sendmonkeyEventAndGetResponse() 方 法 通过 monkeyWriter 传 入 命令 ， 通 过 monkeyReader 获 取 返 回 。 


用 3: 最 终 是 通过 BuferedWriter 和 BuferedReader 操 作对 应 的 monkeySocket。 


























接 发 送 monkey 命 令 ) 。 





进入 到 monkeyDevice.java::takeSnapshot()， 如 代码 清单 9-45 所 示 。 


代码 清单 9-45 monkeyDevice.java::takeSnapshot() 


public monkeyImage takeSnapshot() { 
IChimpImage image = impl.takeSnapshot () 7 
return new monkeyImage (image); 

















MonkeyDevice 的 成 员 变量 impI 的 takesnapshot() 方 法 获取 截 | 





[ 











代码 清单 9-46 takeSnapshot() 








， 并 将 其 转换 成 Monkeylmage 返 匠 


。 实 现 该 接 














的 同样 是 AdbChimpDevice， 如 代码 清单 9-46 所 示 。 





GOverride 


public IChimpImage takeSnapshot() { 


try { 


return new AdbChimpImage (device.getScreenshot ()); 
} catch(TimeoutException e) { 


LOG 


. log (Level . SEVERE, 


"Unable to take snapshot", e); 


return null; 
} catch (AdbCommandRejectedException e) { 


LOG 


. log (Level . SEVERE, 


"Unable to take snapshot", e); 


return null; 
} catch(IOException e) { 


LOG 


-log(Level.SEVERE, "Unable to take snapshot", e); 


return null; 





真正 的 实现 代码 就 一 句 : 通过 调 


代码 清单 9-47 getScreenshot 


GOverride 














device 的 getScreenshot() 方 法 获得 截 








[ 








public RawImage getScreenshot () 


throws TimeoutException, AdbCommandRejectedException, IOException { 


return AdbHelper.getFrameBufer (AndroidDebugBridge.getSocketAddress(), this); 


并 转换 成 AdbChimplmage 对 象 。 继 续 进入 到 Device 的 getScreenshot() 方 法 ， 如 代码 清单 9-47 所 示 。 





又 是 一 行 代码 ， 不 过 看 上 去 很 复杂 的 样子 ， 没 关系 ， 我 们 慢 慢 分 析 。 


首先 通过 AndroidDebugBridge 的 getSocketAddress() 方 法 获取 手机 端的 socket 地 址 。 











IR] 











然后 通过 AdbHelper 的 getFrameBufer() 方 法 读 取 手 机 端的 FrameBufer 的 缓存 ， 即 当前 屏幕 截 





人 看 来 读 取 手机 端的 FrameBufer 的 缓存 是 重点 。 


Ors, 一 起 看 看 ! 


了 解 这 些 ， 继 续 进 入 到 AdbHelper 的 getFrameBufer() 方 法 ， 如 代码 清单 9-48 所 示 。 


代码 清单 9-48 AdbHelper.java::getFrameBufer() 





static RawImage getFrameBufer (InetSocketAddress adbSockAddr, Device device) 
throws TimeoutException, AdbCommandRejectedException, IOException { 
RawImage imageParams = new RawImage(); 
// xuben: 这 是 重点 ， 通 过 formAdbRequest () 获取 
byte[] request = formAdbRequest ("framebufer:"); //SNON-NLS-1$ 
byte[] nudge = ( 
0 


ti 
byte[] reply; 
SocketChannel adbChan = null; 
try { 
adbChan = SocketChannel .open (adbSockAddr) ; 
adbChan.configureBlocking (false); 
setDevice (adbChan, device); 
// xuben: 将 转换 后 的 命令 写 入 adb channel, 4835 44-447 
write(adbChan, request); 
// xuben: 读 取 执行 adb 命 令 后 的 返回 结果 ， 相 当 于 命令 返回 
AdbResponse resp = readAdbResponse (adbChan, false /* readDiagString */); 
if(resp.okay -- false) ( 
throw new AdbCommandRejectedException (resp.message); 
l 
// first the protocol version. 
reply - new byte[4]; 
read(adbChan, reply); 
ByteBufer buf - ByteBufer.wrap (reply); 
buf.order(ByteOrder.LITTLE ENDIAN); 
int version = buf.getInt(); 
// get the header size(this is a count of int) 
int headerSize = RawImage.getHeaderSize (version); 
// read the header 
reply - new byte[headerSize * 4]; 
read(adbChan, reply); 
buf = ByteBufer.wrap (reply); 
buf.order(ByteOrder.LITTLE ENDIAN); 
// fill the RawImage with the header 
if (imageParams.readHeader (version, buf) == false) { 
Log.e("Screenshot", "Unsupported protocol: " + version); 
return null; 
} 
Log.d("ddms", "image params: bpp=" + imageParams.bpp + ", size=" 
+ imageParams.size + ", width-" + imageParams.width 
+ ", height-" + imageParams.height); 
write (adbChan, nudge); 
reply = new byte[imageParams.size]; 
read(adbChan, reply); 
imageParams.data = reply; 
) finally ( 
if(adbChan != null) { 
adbChan.close(); 
} 
} 
return imageParams; 


} 








截屏 大 致 步骤 总 结 如 下 。 


A 


创建 adb channel 并 连接 socket。 


2) 非 阻塞 模式 : 将 该 channel 设 置 为 非 阻塞 模式 。 


Ww 


字符 转换 : 18 "framebufer" $&73jASCIISE£T8 





Ti 


4) 执行 命令 : 通过 将 转换 后 的 命令 写 入 adb channel 的 方式 执行 命令 。 











5) 结果 获取 : 通过 读 取 执行 adb 命 令 后 的 返回 结果 的 方式 获取 命令 返回 。 








回 








6) 关闭 adb channel。 





步骤 知道 了 ， 原 理 是 什么 呢 ? 


eo. 理 如 下 ! 








1) 根据 adb 协 议 整合 命令 请 求 字 串 “framebufer”。 


2) 通过 formAdbRequest("framebufer:") 将 请 求 发 送 给 服务 器 。 


3) 系统 将 创建 服务 进程 framebufer_service。 


D 


通过 服务 进程 打开 设备 “/dev/graphics/fb0” (此 即 为 FrameBufer 对 应 的 设备 文件 ) 。 








un 
二 
网 








像 信息 都 是 通过 FrameBufer 写 到 设备 屏幕 上 的 ， 通 过 读 取 此 设备 中 的 数据 即 可 获取 当前 上 











FEE 

















具体 读 取代 码 如 代码 清单 9-49 所 示 ， 作 为 课外 作业 供 大 家 自行 研究 。 








代码 清单 9-49 ”获取 当前 屏幕 图 像 














像 。 





void framebufer service (int fd) 

{ 
struct fb var screeninfo vinfo; 
int fb, ofset; 
char x[256]; 


struct fbinfo fbinfo; 

unsigned i, bytespp; 
fb = open("/dev/graphics/fb0", O RDONLY); 
if(fb < 0) goto done; 

if(ioctl(fb, FBIOGET VSCREENINFO, &vinfo) « 0) goto done; 
fcntl(fb, F SETFD, FD CLOEXEC); 

bytespp = vinfo.bits per pixel / 8; 
fbinfo.version = DDMS RAWIMAGE VERSION; 
fbinfo.bpp = vinfo.bits per pixel; 
fbinfo.size = vinfo.xres * vinfo.yres * bytespp; 
fbinfo.width = vinfo.xres; 
fbinfo.height = vinfo.yres; 
fbinfo.red ofset = vinfo.red.ofset; 
fbinfo.red length = vinfo.red.length; 
fbinfo.green ofset - vinfo.green.ofset; 
fbinfo.green length = vinfo.green.length; 
fbinfo.blue ofset = vinfo.blue.ofset; 
fbinfo.blue length = vinfo.blue.length; 
fbinfo.alpha ofset = vinfo.transp.ofset; 
fbinfo.alpha length - vinfo.transp.length; 

/* HACK: for several of our 3d cores a specific alignment 
* is required so the start of the fb may not be an integer number of lines 
* from the base. As a result we are storing the additional ofset in 
* xofset. This is not the correct usage for xofset, it should be added 
* to each line, not just once at the beginning */ 

ofset - vinfo.xofset * bytespp; 

ofset += vinfo.xres * vinfo.yofset * bytespp; 

printf("ofset %d\n", ofset); 

if(writex(fd, &fbinfo, sizeof(fbinfo))) goto done; 

lseek(fb, ofset, SEEK SET); 

for(i = 0; i « fbinfo.size; i += 256) { 
if (readx (fb, &x, 256)) goto done; 
if (writex(fd, &x, 256)) goto done; 

} 

if(readx(fb, &x, fbinfo.size $ 256)) goto done; 

if(writex(fd, &x, fbinfo.size $ 256)) goto done; 

done: 

if(fb >= 0) close(fb); 
close (fd); 








Cem, vidue deni ipn! 


99... 加 油 ! 


92.6 ”文件 存储 


最 后 是 文件 存储 。 





picture.writeToFile('./bugben pic.png', 'png') 





进入 到 monkeylmage.java::writeTofile()， 如 代码 清单 9-50 所 示 。 


代码 清单 9-50 monkeylmage .java::writeTofile() 





public boolean writeToFile(PyObject[] args, String[] kws) { 
ArgParser ap = JythonUtils.createArgParser (args, kws); 
Preconditions.checkNotNull (ap) ; 
String path = ap.getString(0); 
String format = ap.getString(1, null); 
return impl.writeToFile (path, format); 








üt 





对 应 接口 为 IChimplmage， 而 实现 该 接口 的 是 ChimplmageBase， 如 代码 清单 9-51 所 示 。 








代码 清单 9-51  writeTofile() 





GOverride 
public boolean writeToFile(String path, String format) ( 
// xuben: 只 要 格式 不 为 空 ， 则 直接 调用 writeToFileHelper () 
if(format != null) ( 
return writeToFileHelper (path, format); 


l 
// xuben: 如 果 格 式 为 空 且 路 径 不 包含 后 级， 则 默认 格式 为 png 
int ofset = path.lastIndexOf('.'); 
if(ofset < 0) ( 
return writeToFileHelper (path, "png"); 


l 
// xuben: 如 果 格 式 为 空 但 路 径 包 含 后 级， 则 取出 后 组 进行 判断 
String ext = path.substring(ofset + 1); 
Iterator«ImageWriter» writers = ImageIO.getImageWritersBySufix (ext); 
// xuben: 如 果 后 组 不 符合 则 默认 格式 为 png 
if(!writers.hasNext()) ( 
return writeToFileHelper (path, "png"); 


l 
// xuben: 如 果 后 缀 符合 则 通过 convertSnapshot () 获取 image 
ImageWriter writer = writers.next(); 
BuferedImage image = convertSnapshot(); 
// xuben: 创建 文件 以 准备 将 图 像 写 入 该 文件 
try { 
File f = new File(path); 
f.delete(); 
ImageOutputStream outputStream = ImageIO.createlmageOutputStream(f); 
writer.setOutput (outputStream); 
// xuben: 将 image 写 入 该 文件 


try ( 
writer.write (image); 
) finally ( 


writer.dispose(); 
outputStream.flush(); 
} 
} catch(IOException e) { 
return false; 
l 


return true; 








文件 存储 具体 步骤 如 下 。 
1) 格式 确认 。 
. 如 果 格式 为 空 且 路 径 不 包含 后 组 ， 则 默认 格式 为 png。 


“ 如 果 格 式 为 空 但 路 径 包 含 后 级 ， 则 取出 后 级 进行 判断 。 


“ 如 果 后 组 不 符合 则 默认 格式 为 png。 
2) 获取 image: 如 果 后 缀 符合 则 通过 convertSnapshot() 方 法 获取 image。 
3) 文件 写 入 。 


“ 只 要 格式 不 为 空 ， 则 直接 调用 writeTofileHelper0 方 法 写 文件 。 











+ 创建 文件 以 准备 将 图 像 写 入 该 文件 。 





+ 将 image 写 入 该 文件 。 


SAME SHEE RF! 





实际 写 文件 是 由 writeToFileHelper 完 成 ， 如 代码 清单 9-52 所 示 。 





代码 清单 9-52 writeTofileHelper() 





private boolean writeToFileHelper(String path, String format) { 
BuferedImage argb = convertSnapshot (); 
try ( 
ImagelO.write(argb, format, new File(path)); 
} catch(IOException e) { 
return false; 
} 
return true; 


} 














最 终 调用 的 是 Java 的 ImagelO.write() 方 法 。 








不 知道 大 家 注意 没有 ， 这 里 除了 传 入 path、format 外 ， 也 需要 通过 convertSsnapshot() 方 法 得 到 image， 让 我 们 来 看 看 convertSnapshot() 方 法 ， 如 代码 清单 9-53 所 示 。 


代码 清单 9-53 convertSnapshot() 





private BuferedImage convertSnapshot() ( 
// xuben: 通过 getBuferedImage () # Rimage 
BuferedImage image = getBuferedImage(); 
// xuben: 通过 BuferedImage () 将 image 转 换 为 RRGB 以 便 ImageIO 写 入 
BuferedImage argb = new BuferedImage (image.getWidth(), image.getHeight(), 
BuferedImage.TYPE_INT_ARGB) ; 
Graphics g = argb.createGraphics () ; 
g.drawImage(image, 0, 0, null); 
g.dispose () ; 
return argh; 





继续 进入 到 Buferedlmage::getBuferedlmage()， 如 代码 清单 9-54 所 示 。 


代码 清单 9-54 Buferedlmage::getBuferedlmage() 





GOverride 
public BuferedImage getBuferedImage () 
// xuben: Se 则 读 取 该 图 像 
if(cachedBuferedImage !- null) ( 
BuferedImage img = cachedBuferedImage.get(); 
if(img != null) ( 
return img; 


} 


} 

// xuben: 若 cachedBuferedImage 中 无 图 像 

// 则 通过 createBuferedImage () 获取 图 像 

BuferedImage img = createBuferedImage(); 
cachedBuferedImage = new WeakReference<BuferedImage> (img); 
return img; 





这 里 又 是 通过 Buferedlmage::createBuferedlmage() 方 法 来 创建 的 ， 这 个 createBufered-lmage() 抽 象 方法 则 是 通过 AdbChimplmage 来 实现 的 ， 即 AdbChimplmage::createBuferedlmage(): 


GOverride 
public BuferedImage createBuferedImage() { 
return ImageUtils.convertImage (image); 


) 














这 里 又 是 调用 ImageUtils.convertlImage() 方 法 来 实现 的 ， 如 代码 清单 9-55 所 示 。 





代码 清单 9-55 convertlmage() 





public static BuferedImage convertImage (RawImage rawImage, BuferedImage image) { 
switch(rawImage.bpp) { 
case 16: 
return rawImagel6toARGB (image, rawImage) ; 
case 32: 
return rawImage32toARGB (rawImage); 
} 
return null; 
} 
public static BuferedImage convertImage (RawImage rawImage) { 
return convertImage (rawImage, null); 


} 





而 这 里 处 理 的 image， 就 是 截屏 时 传 入 给 AdbChimplmage 构 造 函数 的 ， 如 下 。 





new AdbChimpImage (device.getScreenshot ()); 





Se 
Sof, JR RIG AdbChimplImage Ab 38k! 








EAT! 转 了 


9.3 monkeyrunner 的 原理 总 结 


Ge ， 对 整个 monkeyrunnet 原 理 总 结 一 下 吧 ! 
,ee 言 ， 最 重要 的 就 是 chimpchat 了。 

人 是 啊 是 啊 ， 每 次 调用 到 最 后 都 会 调用 到 这 家 伙 ! 

$6, 根 到 底 ，chimpchat 对 命令 的 处 理 又 是 通过 ddmlib 库 来 完成 的 。 
s; 


人 《monkeyrunner 都 有 哪些 命令 呢 ? 


, C POR 通过 “父亲 ”发 命令 和 通过 “母亲 ”发 命令 。 


SSH, BARA A? 


$9... 通过 “父亲 ”发 命令 ， 就 是 通过 monkeyrunner 的 “父亲 ”monkey 来 发 命令 ， 比如 press、type、touch 和 drag 等 常用 操作 类 命令 均 来 自 monkey。 
E 
SAR ARE & BIE? 


a 先 在 目标 机 器 上 启动 monkey 以 监听 端口 接受 连接 ( 即 通 过 adb shell 发 送 命令 "monkey-port 12345") ， 然 后 通过 连接 该 端口 建立 socket 即 可 发 送 monkey 命 令 。 





全 想起 来 了 ， 那 么 什么 是 通过 “母亲 ”发 命令 ? 


eo 比如 installPackage、startActivity、takeSnapshot 和 reboot 等 方法 均 是 通过 adb 进 行 发 送 。 
通过 “母亲 ”发 命令 ， 就 是 通过 adb 服 务 器 与 目标 设备 的 adb 守 护 进程 进行 通信 。 


s» 
有 这 个 具体 又 怎么 发 呢 ? 








QO Lennon 请 求 ， 把 命令 直接 发 给 adb 服 务 器 。 


另 一 种 则 是 通过 发 送 adb 协 议 请 求 ， 建 立 一 个 和 adb 服 务 器 通信 的 adb shell 的 socket 连 接 通 道 ， 这 样 就 可 以 通过 adb 进 行 通信 了 。 


< 从 哦 ， 原 来 如 此 ， 看 来 monkeyrunner 的 “父亲 ”” 和 “母亲 ”都 很 给 力 呢 ! 





(e 
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第 10 章 Instrumentation 原 理 分 析 





本 书 最 艰巨 的 任务 开始 了 ，Instrumentation 分 析 ! 


10.1 Instrumentation 源 码 结构 
Instrumentation 源 码 位 于 “~\frameworks\base\test-runner\src” 下 。 


99, snnt, 分 层次 显示 如 下 。 





一 级 源码 树 ， 如 图 10-1 所 示 。 


android 


——test 
ock 


suitebuilder 


L—annotatio 


junit 
Inner 
extul 





图 10-1 Instrumentation— 2A IR 45 BY 


Se 
全 性 哇 ， 不 仅 包 括 test 目 录 下 的 Instrumentation 的 直接 源码 ， 还 包括 了 单元 测试 基础 框架 JUnit 的 源码 。 














然后 是 二 级 源码 树 ， 先 来 看 看 test 目 录 下 的 源码 树 ， 如 图 10-2 所 示 。 





三 级 源码 树 中 ， 一 个 是 test 目 录 下 mock 源 码 ， 如 图 10-3 所 示 。 





还 有 一 个 是 suitebuilder 下 的 源码 ， 如 图 10-4 所 示 。 


ActivitylInstrunmentat ionTestCase. java 
ActivityInstrunmentat ionTestCase2. java 
ActivityTestCase. java 
ActivityUnitTestCase. java 
AndroidTestRunner. java 


ApplicationTestCase. java 

AssertionFailedError. java 

ClassPathPackagelInfo.java 

Class PathPackageInfoSource. java 

ConparisonFailure. java 

DatabaseTestUtils.java 

InstrunmentationCorelTest Runner. java 

InstrunentationTestRunner. java 

InstrunmentationUtils.java 

IsolatedContext. java 

LaunchPerfornanceBase. java 

LoaderTestCase. java T— pU m. sm tw 
Morefisserts. java pr 
NoExecTestResult. java 7 
PackagelnfoSources .java i 
PerfornanceCollectorTestCase.java ov 好 多 05 多 多 到 | 
ProviderTestCase. java ‘ 
ProviderTestCase2. java ° 


^ 


RenaningDe legat ingContext . java 六 ~- W 4t STER x 7 
ServiceTestCase. java ns Ue )-^ 
SinpleCache . java s / 
SingleLaunchfict ivityTestCase. java ga \ june’ 
SyncBaselInstrunentation.java Sec LIS P, 

TestCase. java -= 
TestCaseUtil.java N & P 

TestPrinter. java pt Le 

TestRunner. java i. 
TestSuiteProvider. java = 


TinedTest. java 
TouchUtils.java 
Viewhsserts. java 





图 10-2 Instrumentation — Zt 7g AY 4#} 


MockApplication. java 
MockContentProvider. java 
MockContentResolver.java 
MockContext.java 
MockCursor. java 
MockDialogInterface. java 
MockI Content Provider. jave 
MockPackageManager.Jjava 
MockResources.java 
package.html 





最 后 是 JUnit 源 码 树 ， 如 图 10-5 所 示 。 


uitebuilder 
AssignableFron. java 
InstrumentationTestSuiteBuilder. java 
package.html 
omokelestSuiteBuilder. java 
TestGrouping. java 
TestMethod. java 
TestPredicates.java 
TestSuiteBuilder. java 
UnitTestSuiteBuilder. java 


annotation 
HasAnnotation. java 
HasClassAnnotation. java 
HasMet hodAnnotat ion. java 
package . html 


图 10-4 Instrumentation = 2 78 74 f[suitebuilder 





junit 
MODULE. LI CENSE, CPL 


Unner 
ClassPathTestCollector. java 
exc luded.properties 
Failure DetailView. java 
LoadinglTestCollector. java 


package . html 

Re loadingTestSuiteLoader. java 
SimpleTestCollector. java 
Sorter. java 
TestCaseClassLoader.java 
TestCollector.java 


extul 
package.html 





图 10-5 JUnit 源码 树 
这 就 是 完整 的 Instrumentation 源 码 树 ， 看 上 去 非常 吓人 ! 


So 
SK, HOM LAF VE? 


BO EN 试 框架 而 言 ， 因 为 其 与 待 测 项 目 深度 绑 定 ， 其 对 控件 的 控制 也 与 应 用 程序 的 控制 大 致 无 二 ， 和 测试 相关 的 其 实 不 多 。 
05... is 


L CANPHRIERTENPPP, 





Instrumentation 切 入 点 的 3 个 问题 ， 如 图 10-6 所 示 。 











-一 ”测试 框架 如 何 运 行 ? 





一 一 一 如 何 启动 应 用 ? ， 





一 一 。 如 何 捕获 控件 ? ， 


10-6 Instrumentation 切 入 点 的 3 个 问题 


知道 了 框架 运行 原理 ， 在 此 基础 上 深入 了 解 启动 应 用 的 原理 和 捕获 控件 的 原理 ， 剩 下 的 控件 操控 等 就 按照 应 用 程序 控件 操控 。 





有 的 同学 看 完 会 觉得 乱 ， 这 个 不 要 紧 ， 等 你 真正 着 手 开 始 Instrumentation 测 试用 例 编写 时 ， 你 会 发 现 ， 这 3 个 方面 将 覆盖 你 所 面临 的 核心 问题 ， 如 图 10-7 所 示 。 


还 有 的 同学 会 觉得 不 够 过 交 ， 这 是 Instrumentation 紧 耦合 造成 的 〈 一 个 与 应 用 程序 耦合 太 紧 ， 源 码 依赖 性 太 强 ， 不 够 独立 的 框架 自然 可 哨 的 骨头 就 少 ) 。 不 过 大 家 别 着 急 ， 未 来 分 析 UIAutomator 
时 ， 你 将 看 到 整个 控制 的 全 狐 一 一 一 个 更 好 、 更 强大 的 测试 框架 的 全 狐 。 


InstrumentationTestRunner 


4 EGI- 
t 测试 框架 如 何 运行 ? JInstrumentation 测 试 运行 


启动 被 测 应 用 


一 ”如何 启 动 应 用 ? :istartActivity() 
startActivity0 后 遗 症 


连接 ViewServer 


| _| 获 取 设备 应 用 信息 
RAPER? | euni 


绘制 控件 树 视图 








10-7 Instrumentation A&A AT 
10.2.1 从 InstrumentationTestRunner 说 开 来 
BOs 还 记得 第 4 章 中 HelloBugbenTestBase 项 目 中 的 AndroidManiFestxml? 
总 怎么 了 ? 
eo. 包含 了 一 个 非常 核心 的 标签 : <Instrumentation> 标 签 ， 并 将 “com.xuben.hellobugben” 设 为 其 targetPackage， 即 测试 对 象 。 


AndroidManifest.xml， 如 代码 清单 10-1 所 示 。 


代码 清单 10-1 AndroidManifest.xml 





<?xml version-"1.0" encoding="utf-8"?> 
«manifest xmlns:android-"http://schemas.android.com/apk/res/android" 
package-"com. xuben.hellobugben.test" 
android:versionCode-"1" 
android:versionName-"1.0" » 
«uses-sdk android:minSdkVersion-"10" /» 
«Instrumentation 
android:name-"android.test.InstrumentationTestRunner" 
android:targetPackage-"com.xuben.hellobugben" /» 
«application 
android: icon="@drawable/ic_launcher" 
android: label="@string/app_ name" > 
<uses-library android:name-"android.test.runner" /» 
«/application» 
«/manifest» 





在 这 个 标签 里 面 ， 设 置 了 运行 测试 用 例 的 类 ， 即 android.test.InstrumentationTestRunner。 


既然 Instrumentation 就 是 通过 这 个 类 进行 测试 ， 那 还 等 什么 ， 直 接 进 入 Instrumentation-TestRunnerjava 看 个 究竟 吧 ! 


在 “~\frameworks\baseNtest-runnemsrc\androidNtest” 中 找到 InstrumentationTestRunnerjava， 先 来 看 看 它 的 onCreate() 方 法 ， 如 代码 清单 10-2 所 示 。 


代码 清单 10-2 InstrumentationTestRunner.java::onCreate() 





GOverride 
public void onCreate (Bundle arguments) { 
super.onCreate (arguments) ; 
mArguments = arguments; 
// xuben: 获取 测试 类 的 Apk 路 径 以 供 TestSuiteBuilders 使 用 
String[] apkPaths = 
(getTargetContext ().getPackageCodePath(), getContext () .getPackageCodePath () }; 
ClassPathPackageInfoSource.setApkPaths (apkPaths) ; 
Predicate<TestMethod> testSizePredicate = null; 
Predicate<TestMethod> testAnnotationPredicate = null; 
Predicate<TestMethod> testNotAnnotationPredicate = null; 
String testClassesArg = null; 
boolean logOnly = false; 
if (arguments != null) 
// xuben: 环境 解析 ， 测 试 类 名 作为 参数 传递 需 重 写 元 数据 声明 
testClassesArg = arguments.getString (ARGUMENT TEST CLASS); 
mDebug = getBooleanArgument (arguments, "debug"); 
mJustCount = getBooleanArgument (arguments, "count"); 
mSuiteAssignmentMode = getBooleanArgument (arguments, "suiteAssignment"); 
mPackageOfTests = arguments.getString (ARGUMENT TEST PACKAGE); 
testSizePredicate = getSizePredicateFromArg( ` "i 
arguments.getString (ARGUMENT TEST SIZE PREDICATE)); 
testAnnotationPredicate = getAnnotationPredicate( 
arguments.getString (ARGUMENT ANNOTATION)); 
testNotAnnotationPredicate = getNotAnnotationPredicate ( 
arguments .getString (ARGUMENT NOT ANNOTATION) ) ; 
logOnly = getBooleanArgument (arguments, ARGUMENT LOG ONLY) ; 
mCoverage = getBooleanArgument (arguments, "coverage") ; 
mCoverageFilePath = arguments .getString ("coverageFile") ; 
try { 
Object delay = arguments.get (ARGUMENT DELAY MSEC) ; 
if (delay != null) mDelayMsec = Integer.parseInt (delay.toString()); 
} catch (NumberFormatException e) { 
Log.e(LOG TAG, "Invalid delay msec parameter", e); 
} 


l 
// xuben: 加 载 测试 类 
TestSuiteBuilder testSuiteBuilder = new TestSuiteBuilder (getClass () .getName () , 
getTargetContext () .getClassLoader ()); 
if (testSizePredicate !- null) ( 
testSuiteBuilder.addRequirements (testSizePredicate); 


f 
if (testAnnotationPredicate != null) { 
testSuiteBuilder.addRequirements (testAnnotationPredicate); 


} 
if (testNotAnnotationPredicate != null) { 
testSuiteBuilder.addRequirements (testNotAnnotationPredicate); 


l 
if (testClassesArg -- null) ( 
if (mPackageOfTests != null) { 
testSuiteBuilder.includePackages (mPackageOfTests) ; 
) else ( 
TestSuite testSuite - getTestSuite(); 
if (testSuite !- null) ( 
testSuiteBuilder.addTestSuite (testSuite); 
) else ( 
// xuben: 若 未 提供 任何 包 或 类 ， 也 没有 指定 test suite， 则 将 添加 所 有 测试 
testSuiteBuilder.includePackages (""); 
} 
} 
} else ( 
parseTestClasses (testClassesArg, testSuiteBuilder); 
l 
testSuiteBuilder.addRequirements (getBuilderRequirements ()); 
// xuben: i&itgetAndroidTestRunner () 方法 获取 运行 测试 用 例 的 
// AndroidTestRunner 对 象 ， 并 对 这 个 对 象 进行 设置 ， 并 添加 测试 监听 器 
mTestRunner = getAndroidTestRunner(); 
mTestRunner.setContext (getTargetContext ()); 
mTestRunner.setInstrumentation (this); 
mTestRunner.setSkipExecution (logOnly); 
mTestRunner.setTest (testSuiteBuilder.build()); 
mTestCount = mTestRunner.getTestCases () .size(); 
if (mSuiteAssignmentMode) { 
mTestRunner.addTestListener (new SuiteAssignmentPrinter()); 
) else ( 
WatcherResultPrinter resultPrinter = new WatcherResultPrinter (mTestCount) ; 
mTestRunner.addTestListener (new TestPrinter("TestRunner", false)); 
mTestRunner.addTestListener (resultPrinter) ; 
mTestRunner.setPerformanceResultsWriter (resultPrinter) ; 


l 
// xuben: 启动 测试 
start(); 





不 难 发 现 ， 整 个 准备 过 程 如 下 。 


1) 环境 解析 : 测试 类 名 作为 参数 传递 需 





元 数据 声明 。 





2) 加 载 测试 类 : 通过 TestSuiteBuilder(getClass().getName(),getTargetContext().getClassLoader()) 方 法 进行 测试 类 加 载 。 











3) 运行 准备 : 获取 运行 测试 用 例 的 AndroidTestRunner 对 象 ， 对 其 进行 设置 并 添加 必要 的 测试 监听 器 。 








4) 开始 执行 : 通过 start() 方 法 运行 测试 。 





E. 
人才 最 后 这 个 start() 方 法 是 测试 运行 的 关键 。 
SR eu "T 

你 也 看 出 来 了 ? 那 咱们 进去 瞧 瞧 吧 ! 


10.2.2 Instrumentation 测 试 运行 


进入 start() 方 法 ， 随 之 进入 InstrumentationTestRunner 的 父 类 一 一 Instrumentation 类 ， 如 代码 清单 10-3 所 示 。 


代码 清单 10-3 start() 





public void start() { 
if (mRunner != null) ( 
throw new RuntimeException ("Instrumentation already started"); 


} 

// xuben: 创建 Instrumentation 专 属 线程 : InstrumentationThread 

mRunner = new InstrumentationThread("Instr: " + getClass().getName()); 
mRunner.start(); 








里 创建 了 Instrumentation 专 属 线程 : InstrumentationThread 。 


O= 由 于 这 里 是 通过 InstrumentationTestRunner 调 用 的 start( 方 法 ， 所 以 这 里 的 getClass0.getName0 返 回 的 新 线程 名 就 是 "android.test.InstrumentationTestRunner" o 


继续 跟 进 InstrumentationThread 线 程 ， 如 代码 清单 10-4 所 示 。 





代码 清单 10-4 InstrumentationThread 





private final class InstrumentationThread extends Thread { 
public InstrumentationThread(String name) ( 
super (name) ; 


l 
public void run() ( 
// xuben: 4|3tActivityManagerNatives] $- 
IActivityManager am = ActivityManagerNative.getDefault(); 
try { 
// xuben: 设置 线程 优先 级 
Process.setThreadPriority (Process.THREAD PRIORITY URGENT DISPLAY); 
) catch (RuntimeException e) ( E B z 
Log.w(TAG, "Exception setting priority of Instrumentation thread " 
+ Process.myTid(), e); 
} 
if (mAutomaticPerformanceSnapshots) { 
startPerformanceSnapshot () ; 


} 
// xuben: 启动 测试 
onStart(); 








因为 这 里 创建 的 线程 就 是 “android.test.InstrumentationTestRunner”， 所 以 onStart() 方 法 又 将 我 们 带 回 到 InstrumentationTestRunner 中 。 





有 点 像 小 狗 玩 转圈 圈 游 戏 ! 
InstrumentationTestRunner 中 的 onStart() 方 法 ， 如 代码 清单 10-5 所 示 。 


代码 清单 10-5 onStart() 





GOverride 
public void onStart() { 
prepareLooper () ; 
if (mJustCount) { 
mResults.putString(Instrumentation.REPORT KEY IDENTIFIER, REPORT VALUE ID); 
mResults.putInt(REPORT KEY NUM TOTAL, mTestCount); B ~ 
finish (Activity.RESULT OK, mResults) ; 
} else { ~ 
if (mDebug) { 
Debug.waitForDebugger () ; 
} 
ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream(); 
PrintStream writer = new PrintStream(byteArrayOutputStream) ; 
try { 
StringResultPrinter resultPrinter = new StringResultPrinter (writer) ; 
mTestRunner.addTestListener (resultPrinter) ; 
long startTime = System.currentTimeMillis (); 
// xuben: 通过 AndroidTestRunner 对 象 运行 测试 
mTestRunner.runTest (); 
long runTime = System.currentTimeMillis() - startTime; 
resultPrinter.print (mTestRunner.getTestResult(), runTime); 
) catch (Throwable t) ( 
writer.println(String.format ("Test run aborted due to unexpected exception: $s", 
t.getMessage ())); 
t.printStackTrace (writer); 
) finally ( 
mResults.putString(Instrumentation.REPORT KEY STREAMRESULT, 
String.format ("\nTest results for %s=%s", 
mTestRunner.getTestClassName () , 
byteArrayOutputStream.toString())); 
if (mCoverage) ( 
generateCoverageReport () ; 
} 
writer.close(); 
// xuben: 被 测 应 用 从 Instrumentation 测 试 环境 中 退出 ， 以 免 影 响 
/1 应 用 程序 下 次 正常 启动 
finish(Activity.RESULT OK, mResults); 








虽然 这 里 的 finish() 方 法 很 有 深意 〈 感 兴趣 的 同学 可 自行 研究 ) ， 但 此 处 核心 只 有 一 句 : mTestRunner.runTest()， 即 通过 AndroidTestRunner 对 象 运行 测试 。 























那 还 等 什么 呢 ， 直 接 进 入 AndroidTestRunner， 如 代码 清单 10-6 所 示 。 





代码 清单 10-6 AndroidTestRunner 





public void runTest(TestResult testResult) ( 
mTestResult = testResult; 
for (TestListener testListener : mTestListeners) { 
mTestResult.addListener (testListener); 


// xuben: if itmInstrumentation.getContext () 获取 testContext 

Context testContext = mInstrumentation == null ? mContext : mInstrumentation.getContext (); 

// xuben: 循环 执行 测试 用 例 

for (TestCase testCase : mTestCases) ( 
setContextlfAndroidTestCase (testCase, mContext, testContext); 
setInstrumentationIInstrumentationTestCase (testCase, mInstrumentation); 
setPerformanceWriterlfPerformanceCollectorTestCase (testCase, mPerfWriter); 
testCase.run (mTestResult); 

l 

} 























到 这 里 ， 测 试用 例 执行 的 整个 流程 完全 清晰 了 ， 如 下 。 





1) 创建 线程 : 通过 Instrumentation 创 建 Instrumentation 专 属 线程 InstrumentationThread。 


2) 获取 线程 : 通过 InstrumentationTestRunner 获 取 线 程 “android.test.Instrumentation-TestRunner” , 





3) 执行 用 例 : 通过 AndroidTestRunner 对 象 循环 执行 测试 用 例 。 





人 作为 运行 测试 用 例 类 ，InstrumentationTestRunner 为 什么 要 借助 于 Intrumentation 来 控制 被 测 应 用 的 实例 ? 又 为 什么 要 在 同一 个 进程 中 运行 测试 程序 和 主 程序 ? 


96, 为 这 样 就 能 确保 测试 程序 与 主 程序 间 直 接 交互 ， 并 控制 了 整个 测试 运行 和 结果 输出 ， 最 终 将 测试 结果 输出 到 合适 的 地 方 。 
10.2.3 ”启动 被 测 应 用 


让 我 们 回顾 一 下 “Instrumentation 的 今生 ”中 测试 项 目 代 码 ( 记 不 住 的 同学 可 以 翻 回 第 4 章 ) ， 从 中 看 到 我 们 熟悉 的 JUnit 基 础 框架 。 











1) 测试 用 例 开始 前 的 资源 准备 和 预先 设置 : Setup() 方 法 。 





2) 测试 用 例 步骤 执行 及 验证 点 检验 : Assert() 方 法 。 


3) 测试 用 例 结束 后 的 环境 清理 : Teardown() 方 法 。 


























除 此 之 外 ， 诸 如 findViewByld() 方 法 以 及 相关 的 控件 操作 都 与 正常 的 Android 应 用 程序 一 致 ， 这 充分 说 明 ，Instrumentation 测 试 框架 与 应 用 程序 的 耦合 度 非常 高 ， 框 架 对 源码 的 透明 度 要 求 也 非常 高 ， 
对 源码 的 依赖 程度 也 就 不 言 自明 了 。 











» 


SKENIRA TFR, do skigetActivity) FMA AGE SE. 


B® vas, 除了 应 用 操作 ， 剩 下 的 就 是 应 用 启动 和 控件 捕获 了 ， 先 来 看 看 应 用 启动 吧 ! 


先 让 我 们 一 起 到 它 的 父 类 ActivitylnstrumentationTestCase2 中 去 看 看 ， 如 代码 清单 10-7 所 示 。 





代码 清单 10-7 ActivitylnstrumentationTestCase2 


public T getActivity() ( 
Activity a = super.getActivity(); 
if (a = null) { 
// xuben: 设置 初始 触摸 模式 
getInstrumentation () .setInTouchMode (mInitialTouchMode); 
final String targetPackage = 
getInstrumentation () .getTargetContext () .getPackageName () ; 
// xuben: 若 提供 intent， 传 入 该 intent 
if (mActivityIntent = null) { 
a = launchActivity (targetPackage, mActivityClass, null); 
) eise ( 
a = launchActivityWithIntent (targetPackage, mActivityClass, mActivityIntent); 
} 
setActivity (a); 
} 
return (T) a; 


} 





进入 到 launchActivityWithlntent() 方 法 ， 一 下 跳 转 到 InstrumentationTestCase.java， 如 代码 清单 10-8 所 示 。 


代码 清单 10-8 InstrumentationTestCase.java:launchActivityWithIntent() 


launchActivityWithIntent () 
GSuppressWarnings ("unchecked") 
public final «T extends Activity» T launchActivityWithIntent ( 
String pkg, Class«T» activityCls, Intent intent) ( 
intent.setClassName (pkg, activityCls.getName()); 
intent.addFlags (Intent.FLAG ACTIVITY NEW TASK) ; 
// xuben: i&itstartActivitySync () 方法 以 同步 方式 启动 Activity 
T activity = (T) getInstrumentation().startActivitySync (intent); 
getInstrumentation().waitForIdleSync(); 
return activity; 











InstrumentationTestCase 继 承 自 TastCase， 这 里 通过 getlnstrumentation() 方 法 获取 Instrumentation 类 ， 并 通过 Instrumentation 类 的 startActivitySync() 方 法 对 应 用 进行 启动 。 











这 个 转子 绕 得 好 大 ， 绕 来 绕 去 的 ， 继 承 关系 能 帮 我 理 理 吗 ? 
$9. au, 继承 关系 如 下 。 


从 Activitylnstrumentationtestcase2 到 JUnit 的 继承 关系 如 下 。 


JUNIT 


TESTCASE 


INSTRUMENTATIONTESTAASE 


(ACTIVITYTESTCASE 


(ACTIVITYINS TRUMENTATIONTESTCASE2 





< 好 长 的 链条 ， 为 什么 要 绕 这 么 一 个 大 团子 呢 ? 


89. 单 ， 因 为 在 整个 Android 系 统 的 应 用 启动 中 ，Instrumentation 是 其 中 关键 的 一 环 ，Instrumentation 将 在 任何 应 用 程序 运行 前 初始 化 ， 通 过 它 监 测 系统 与 应 用 程序 之 间 的 所 有 交互 。 





而 InstrumentationTestCase 可 以 理解 为 拥有 强大 的 Instrumentation 能 力 的 测试 类 ( 它 既 具备 测试 类 TastCase 的 骨骼 ， 又 兼备 Instrumentation 的 超 能 力 ) 。 
废话 少 说 ， 跟 进 startActivitySync() 方 法 ， 这 就 来 到 了 Instrumentation 类 中 ， 启 动 其 强大 的 功能 ， 如 代码 清单 10-9 所 示 。 


代码 清单 10-9 startActivitySync() 





public Activity startActivitySync(Intent intent) ( 
validateNotAppThread () ; 
synchronized (mSync) { 
intent = new Intent (intent) ; 
// xuben: i&itContext £4 getPackageManager () 获取 待 启动 应 用 Intent 信 息 
ActivityInfo ai = intent.resolveActivityInfo( 
getTargetContext ().getPackageManager(), 0); 
// xuben: 若 该 Intent 信 息 为 空 ， 则 抛 异 常 
if (ai == null) ( 
throw new RuntimeException ("Unable to resolve activity for: " + intent); 
} 
// xuben: 确认 Intent 信 息 与 线程 中 的 intent 保 持 一 致 
String myProc = mThread.getProcessName () ; 
if (lai.processName.equals (myProc)) { 
// todo: if this intent is ambiguous, look here to see if 
// there is a single match that is in our package. 
throw new RuntimeException ("Intent in process " 
* myProc * " resolved to diferent process 
+ ai.processName + ": " + intent); 


} 
intent.setComponent (new ComponentName ( 
ai.applicationInfo.packageName, ai.name)); 
final ActivityWaiter aw = new ActivityWaiter (intent); 
if (mWaitingActivities == null) ( 
mWaitingActivities - new ArrayList(); 
} 
mWaitingActivities.add (aw) ; 
// xuben: 关键 的 一 句 ， 通 过 调用 Context 的 startRctivity() 方法 进行 启动 
getTargetContext () . startActivity (intent); 
// xuben: 同步 等 待 ， 直 到 Activity 运 行 起 来 
do { 
try { 
mSync.wait(); 
} catch (InterruptedException e) { 
} 


} while (mWaitingActivities.contains (aw)); 
return aw.activity; 
} 
} 








不 难 发 现 ， 通 过 startActivitySync() 方 法 以 同步 方式 启动 Activity， 即 在 startActivity() 方 法 后 始终 处 于 等 待 状态 ， 直 到 Activity 运 行 起 来 。 


这 里 最 关键 的 一 句 自然 是 getTargetContext().startActivity(Intent)， 即 调用 Context 类 的 startActivity() 方 法 进行 启动 。 即 : 





public abstract void startActivity(Intent intent); 





10.24 startActivity() 方 法 


£e 

< 人 <% 看 上 去 情况 越 来 越 复杂 了 1! 

$99, ax 此 ， 实 则 不 然 。Activity 的 startActivity0 方法 就 重 载 自 Context， 所 以 这 里 相当 于 直接 从 根子 上 调用 应 用 的 启动 方法 。 
我 们 可 以 先 来 看 看 Activity 的 startActivity(Intent) 方 法 做 了 些 什么 ， 如 代码 清单 10-10 所 示 。 


代码 清单 10-10 startActivity(Intent) 





GOverride 
public void startActivity (Intent intent, Bundle options) ( 
if (options != null) ( 
startActivityForResult (intent, -1, options); 
} else { 


// xuben: i&itstartActivityForResult () 并 传 入 -1， 即 无 需 返 回 结果 
startActivityForResult (intent, -1); 
l 
} 





而 startActivityForResult() 方 法 又 是 如 何 ， 如 代码 清单 10-11 所 示 。 


代码 清单 10-11 startActivityForResult() 





public void startActivityForResult(Intent intent, int requestCode, Bundle options) ( 
if (mParent == null) { 
// xuben: i&itInstrumentationágjexecStartActivity () 进行 启动 
Instrumentation.ActivityResult ar = 
mInstrumentation.execStartActivity ( 
this, mMainThread.getApplicationThread(), mToken, this, 
intent, requestCode, options) ; 
if (ar != null) { 
mMainThread.sendActivityResult ( 
mToken, mEmbeddedID, requestCode, ar.getResultCode(), 
ar.getResultData()); 
} 
if (requestCode >= 0) { 
mStartedActivity = true; 
} 
) else ( 
if (options != null) { 
mParent.startActivityFromChild(this, intent, requestCode, options); 
) else ( 
mParent.startActivityFromChild(this, intent, requestCode); 





哈哈， 通过 execStartActivity(0 方 法 又 回 到 Instrumentation 类 中 。 


来 看 Instrumentation 类 中 的 execStartActivity() 方 法 ， 如 代码 清单 10-12 所 示 。 





I-— — 99 动 应 用 程序 运行 的 进程 。 


代码 清单 10-12 execStartActivity() 


public ActivityResult execStartActivity ( 
Context who, IBinder contextThread, IBinder token, Activity target, 
Intent intent, int requestCode, Bundle options) { 
IApplicationThread whoThread = (IApplicationThread) contextThread; 
if (mActivityMonitors != null) { 
synchronized (mSync) ( 
final int N = mActivityMonitors.size(); 
for (int i=0; i<N; i++) { 
final ActivityMonitor am = mActivityMonitors.get (i); 
if (am.match(who, null, intent)) { 
am.mHitstt; 
if (am.isBlocking()) { 
return requestCode >= 0 ? am.getResult() : null; 
} 
break; 
} 
} 





} 
l 
try { 
intent.setAllowFds (false); 
intent .migrateExtraStreamToClipData () ; 
// xuben: 重点 在 这 里 : iüitActivityManagerNative.getDefault () 得 到 
// ActivityManagerService 的 远程 接口 ActivityManagerProxy 接 口 
// 并 通过 它 来 调用 其 startActivity () 
int result = ActivityManagerNative.getDefault () 
.StartActivity (whoThread, intent, 
intent.resolveTypelfNeeded (who .getContentResolver ()), 
token, target !- null ? target.mEmbeddedID : null, 
requestCode, 0, null, null, options); 
checkStartActivityResult (result, intent); 
} catch (RemoteException e) { 
} 
return null; 


} 








感觉 越 走 越 远 了 ， 哈 哈 ! 好 吧 ， 在 找到 我 们 想 要 的 内 容 之 前 索性 一 路 跟 到 底 ! 


进入 位 于 ActivityManagerNativejava 中 的 ActivityManagerProxy 类 下 面 的 startActivity() 方 法 ， 如 代码 清单 10-13 所 示 。 


代码 清单 10-13 ActivityManagerNative.java::startActivity() 


public int startActivity (IApplicationThread caller, Intent intent, 
String resolvedType, IBinder resultTo, String resultWho, int requestCode, 
int startFlags, String profileFile, 
ParcelFileDescriptor profileFd, Bundle options) throws RemoteException { 
Parcel data - Parcel.obtain(); 
Parcel reply = Parcel.obtain(); 
data.writeInterfaceToken (IActivityManager.descriptor); 
data.writeStrongBinder (caller != null ? caller.asBinder() : null); 
intent.writeToParcel (data, 0); 
data.writeString (resolvedType); 
data.writeStrongBinder (resultTo); 
data.writeString (resultWho); 
data.writeInt (requestCode); 
data.writeInt (startFlags); 
data.writeString (profileFile) ; 
if (profileFd != null) { 
data.writeInt (1); 
profileFd.writeToParcel(data, rcelable.PARCELABLE WRITE RETURN VALUE); 
) else ( 
data.writeInt (0); 
} 
if (options != null) { 
data.writeInt (1); 
options.writeToParcel (data, 0); 
) else ( 
data.writeInt (0); 
} 
mRemote.transact (START ACTIVITY TRANSACTION, data, reply, 0); 
reply.readException () 7 
int result = reply.readInt(); 
reply.recycle(); 
data.recycle(); 
return result; 





Qi 这 里 的 参数 caller 为 ApplicationThread 类 型 的 binder 实 体 ， 而 参数 resultTo 为 一 个 binder 实 体 的 远程 接口 ， 通 过 binder 进 入 到 ActivityManagerService 的 startActivity0 方 法 中 。 


通过 binder 进 入 到 ActivityManagerService 的 startActivity() 中 ， 如 代码 清单 10-14 所 示 。 





代码 清单 10-14 startActivity0 





public final int startActivity(IApplicationThread caller, 
Intent intent, String resolvedType, IBinder resultTo, 
String resultWho, int requestCode, int startFlags, 
String profileFile, ParcelFileDescriptor profileFd, Bundle options) { 
return startActivityAsUser(caller, intent, resolvedType, resultTo, resultWho, requestCode, 
startFlags, profileFile, profileFd, options, UserHandle.getCallingUserId()); 








终于 不 叫 startActivityg0 了 ， 但 貌似 后 遗 症 还 很 多 ， 喘 口气 ， 咱 们 继续 跟 进 ! 


10.2.5 ”startActivity() 方 法 后 遗 症 


休息 回来 ， 继 续 跟 进 startActivityAsUser0 方 法 ， 如 代码 清单 10-15 所 示 。 





代码 清单 10-15 startActivityAsUser() 





public final int startActivityAsUser (IApplicationThread caller, 
Intent intent, String resolvedType, IBinder resultTo, 
String resultWho, int requestCode, int startFlags, 
String profileFile, ParcelFileDescriptor profileFd, Bundle options, int userId) ( 
enforceNotIsolatedCaller ("startActivity"); 
userId = handleIncomingUser (Binder.getCallingPid(), Binder.getCallingUid(), userId, 
false, true, "startActivity", null); 
return mMainStack.startActivityMayWait (caller, -1, intent, resolvedType, 
resultTo, resultWho, requestCode, startFlags, profileFile, profileFd, 
null, null, options, userId); 








startActivityAsUser() 方 法 继续 将 参数 传 给 mMainstack.startActivityMayWait() 方 法 并 返回 ， 这 里 的 mnMainstack 为 ActivityStack 对 象 ， 继 续 跟 进 到 ActivityStack.java。 





“KF, 十万火急! startActivityMayWait) 方法 的 代码 超级 长 ! ! ! 


eo 没事 ， 咱 们 先 仔细 过 了 一 遍 ， 只 留 下 对 咱们 有 用 的 几 块 就 行 。 


startActivityMayWait() 方 法 ( 仅 保 留 相 关 代码 ) ， 如 代码 清单 10-16 所 示 。 





代码 清单 10-16 startActivityMayWait0 





final int startActivityMayWait (IApplicationThread caller, int callingUid, 
Intent intent, String resolvedType, IBinder resultTo, 
String resultWho, int requestCode, int startFlags, String profileFile, 
ParcelFileDescriptor profileFd, WaitResult outResult, Configuration config, 
Bundle options, int userId) ( 
try { 
// xuben: 通过 解析 intent 获 取 MainActivity 的 相关 信息 并 
// 保存 在 aInfo 中 
ResolveInfo rInfo = 
AppGlobals.getPackageManager () .resolveIntent ( 
intent, null, 
PackageManager.MATCH DEFAULT ONLY 
| ActivityManagerService.STOCK PM FLAGS, userId); 
aInfo = rInfo != null ? rInfo.activityInfo : null; 
aInfo = mService.getActivityInfoForUser (aInfo, userId); 
} catch (RemoteException e) { 
aInfo = null; 


// xuben: iit 79 A startActivityLocked () 将 参数 传 入 

int res = startActivityLocked(caller, intent, resolvedType, 
aInfo, resultTo, resultWho, requestCode, callingPid, callingUid, 
startFlags, options, componentSpecified, null); 








这 里 通过 解析 Intent 获 取 mainActivity 的 相关 信息 并 保存 在 ainfo 中 ， 再 将 ainfo 变 量 与 其 他 参数 一 并 传 入 到 startActivityLocked() 方 法 中 。 





sstartActivityLocked0 方 法 也 是 奇 长 无 比 ， 为 了 不 让 大 家 跟着 头晕， 学 奔 哥 摘录 如 下 。 


进入 startActivityLocked() 方 法 ， 








点 摘录 如 代码 清单 10-17 所 示 。 





代码 清单 10-17 startActivityLocked() 





final int startActivityLocked (IApplicationThread caller, 

Intent intent, String resolvedType, ActivityInfo aInfo, IBinder resultTo, 
String resultWho, int requestCode, 
int callingPid, int callingUid, int startFlags, Bundle options, 
boolean componentSpecified, ActivityRecord[] outActivity) { 
int err = ActivityManager.START SUCCESS; 

// xuben: 到 这 里 ，caller 终 于 发 挥 作用 ， 通 过 caller 获 取 应 用 程序 

// 的 进程 信息 ， 并 保存 在 callerApp 中 

ProcessRecord callerApp = null; 

if (caller != null) { 
callerApp = mService.getRecordForAppLocked (caller); 
if (callerApp !- null) ( 


callingPid - callerApp.pid; 
callingUid - callerApp.info.uid; 
) else ( 


Slog.w(TAG, "Unable to find app for caller " * caller 
+" (pid-" + callingPid + ") when starting: " 
* intent.toString()); 

err = ActivityManager.START PERMISSION DENIED; 


// xuben: 创建 要 启动 的 Activity 的 相关 信息 并 保存 在 RctivityRecord 对 象 中 

ActivityRecord r = new ActivityRecord (mService, this, callerApp, callingUid, 
intent, resolvedType, aInfo, mService.mConfiguration, 
resultRecord, resultWho, requestCode, componentSpecified); 

// xuben: 将 r 传 入 startActivityUncheckedLocked() 

err = startActivityUncheckedLocked(r, sourceRecord, startFlags, true, options); 


return err; 





这 里 创建 要 启动 的 Activity 的 相关 信息 ， 保 存在 ActivityRecord 对 象 中 并 传 入 startActivity-UncheckedLocked() 方 法 ， 继 续 跟 进 。 






这 又 是 一 个 巨 长 无 比 的 方法 ， 哎 ， 看 来 ActivityStack 这 个 类 不 能 随便 进 啊 ， 一 脚 踩 进 沼泽 地 ! 算 了 ， 不 说 了 ， 说 了 都 是 泪 。 














进入 startActivityUncheckedLocked() 方 法 ， 重 点 摘录 如 代码 清单 10-18 所 示 。 





代码 清单 10-18 startActivityUncheckedLocked() 





final int startActivityUncheckedLocked (ActivityRecord r, 
ActivityRecord sourceRecord, int startFlags, boolean doResume, 
Bundle options) ( 
final Intent intent - r.intent; 
final int callingUid - r.launchedFromUid; 
int launchFlags = intent.getFlags(); 
// xuben: 查看 是 否 存 在 执行 Activity 的 task 
if (((launchFlags&Intent.FLAG ACTIVITY NEW TASK) != 0 && 
(launchFlags&Intent.FLAG ACTIVITY MULTIPLE TASK) 一 0) 
|| r.launchMode == ActivityInfo.LAUNCH SINGLE TASK 
|| r.launchMode == ActivityInfo.LAUNCH SINGLE INSTANCE) { 
if (r.resultTo == null) ( 
// xuben: 通过 findTaskLocked () 查 找 是 否 存在 Lask 
ActivityRecord taskTop = r.launchMode != ActivityInfo.LAUNCH SINGLE INSTANCE 
? findTaskLocked(intent, r.info) T 
: findActivityLocked (intent, r.info); 
if (taskTop != null) { 
if (taskTop.task.intent == null) { 
taskTop.task.setIntent (intent, r.info); 


pies 
// xuben: 判断 堆栈 顶端 的 Rctivity 是 否 就 是 即将 要 启动 的 ARctivity 
if (r.packageName != null) ( 
ActivityRecord top = topRunningNonDelayedActivityLocked (notTop) ; 
if (top != null && r.resultTo 一 null) ( 
if (top.realActivity.equals(r.realActivity) && top.userId == r.userId) { 
if (top.app != null && top.app.thread != null) { 
if ((launchFlags&Intent.FLAG ACTIVITY SINGLE TOP) != 0 
|| r.launchMode 一 ActivityInfo.LAUNCH SINGLE TOP 
|| r.launchMode == ActivityInfo.LAUNCH SINGLE TASK) { 
logStartActivity (EventLogTags.AM NEW INTENT, top, top.task); 
if (doResume) ( n 
resumeTopActivityLocked (null); 
$ 
ActivityOptions.abort (options); 
if ((startFlags&ActivityManager.START FLAG ONLY IF NEEDED) != 0) ( 
return ActivityManager.START RETURN INTENT TO CALLER; 
} 
top.deliverNewIntentLocked(callingUid, r.intent); 
return ActivityManager.START DELIVERED TO TOP; 
} 
} 
} 
} 
} else { 
if (r.resultTo != null) ( 
sendActivityResultLocked(-1, 
r.resultTo, r.resultWho, r.requestCode, 
Activity.RESULT CANCELED, null); 
} 
ActivityOptions.abort (options); 
return ActivityManager.START CLASS NOT FOUND; 


l 
// xuben: 创建 新 task 
if (r.resultTo == null && !addingToTask 
&& (launchFlags&Intent.FLAG ACTIVITY NEW TASK) != 0) { 
if (reuseTask — null) { = ds 
mService.mCurTasktt; 
if (mService.mCurTask «- 0) ( 
mService.mCurTask - 1; 
} 
r.setTask(new TaskRecord (mService.mCurTask, r.info, intent), null, true); 
if (DEBUG TASKS) Slog.v(TAG, "Starting new activity " + r 
+ " in new task " + r.task); 
) else ( 
r.setTask(reuseTask, reuseTask, true); 
} 
newTask = true; 
if (!movedHome) { 
moveHomeToFrontFromLaunchLocked (launchFlags) ; 
} 
} else if (sourceRecord !- null) ( 
if (!addingToTask && 
(launchFlags&Intent.FLAG ACTIVITY CLEAR TOP) != 0) { 


return ActivityManager.START SUCCESS; 
l 





经 过 毫 不 留情 的 删除 ， 还 是 很 长 。 


简单 解释 如 下 。 





1) 首先 ， 通 过 findTaskLocked() 方 法 查找 是 否 存在 执行 Activity 的 task。 
2) 接着 ， 判 断 堆栈 顶端 的 Activity 是 否 就 是 即将 要 启动 的 Activity。 


3) 最 后 ， 如 果 不 存 在 执行 Activity 的 task， 堆 栈 顶 端的 Activity 也 不 是 要 启动 的 Activity 的 话 ， 那 我 们 就 得 考虑 新 建 一 个 task 来 启动 这 个 Activity 了 。 
































看 到 这 里 ，startActivity() 方 法 的 后 遗 症 远 没有 结束 ， 不 过 我 们 的 主题 已 经 清楚 了 (当然 ， 你 可 以 步 巴 哥 奔 的 后 尘 ， 继 续 跟 进 ， 直 到 地 老 天 荒 ， 巴 哥 奔 祝 你 Good luck and good night! ) 。 更 详细 的 
解读 参见 《深入 理解 Android: ll) , 


go 还 记得 咱们 跟 进 stattActivity0 方 法 的 初衷 吗 ? 






































Activity 类 的 startActivity(Intent) 方 法 重 载 自 Context 类 的 startActivity(Intent) 方 法 ， 而 跟 到 这 里 我 们 发 现 ， 如 果 直 接 使 用 Context 的 startActivity() 方 法 的 话 ， 就 需要 自己 创建 一 个 新 的 task， 否 则 将 会 
报 异 常 。 























了 解 应 用 启动 的 基本 原理 后 ， 下 面 我 们 将 进入 Instrumentation 最 核心 的 代码 一 一 控件 捕获 ! 











10.2.6 连接 ViewServer 























大 家 对 HierarchyViewer 这 款 工 具 应 该 不 陌生 了 ， 早 在 monkeyrunner 中 我 们 就 通过 device.getHierarchyViewer() 方 法 获取 它 进行 控件 定位 ， 在 Instrumentation 中 HierarchyViewer 更 是 必 不 可 少 的 控 
件 获 取 工 具 。 





eo 现在 ， 就 让 我 们 正式 进入 HierarchyViewet 的 世界 吧 ! 


» 


SS 入 奔 哥 ， 先 给 一 下 HierarchyViewer 的 源码 地 址 吧 ! 

HierarchyViewer 源 码 地 址 : 
“~\sdk\hierarchyviewer2\libs\hierarchyviewerlib\src\com\android\hierarchyviewerlib\" 。 

先 来 看 看 HierarchyViewer 是 如 何 连接 ViewServer 的 。 

这 里 是 通过 HierarchyViewerDirectorjava 中 的 deviceConnected() 方 法 实现 的 ， 如 代码 清单 10-19 所 示 。 


代码 清单 10-19 HierarchyViewerDirector.java::deviceConnected() 





GOverride 
public void deviceConnected(final IDevice device) ( 
executeInBackground ("Connecting device", new Runnable() { 
GOverride 
public void run() ( 
if (DeviceSelectionModel.getModel().containsDevice (device)) { 
windowsChanged (device); 
} else if (device.isOnline()) { 
// xuben: 将 手机 端的 4939 端 口 映 射 到 PC 端 
DeviceBridge.setupDeviceForward (device); 
// xuben: 判断 ViewServer 是 否 开局 
if (!DeviceBridge.isViewServerRunning (device)) ( 
// xuben: 若 ViewServer 未 开启 ， 则 开启 
if (!DeviceBridge.startViewServer (device)) { 


// Let's do something interesting herehttp://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/... Tr 
// in 2 seconds. 
try { 


Thread.sleep (2000) ; 

} catch (InterruptedException e) { 

} 

if (!DeviceBridge.startViewServer (device)) { 
Log.e(TAG, "Unable to debug device " + device); 
DeviceBridge.removeDeviceForward (device); 

} else ( 
// xuben: 这 是 关键 中 的 关键 ， 获 取 该 设备 
// ViewServer 信 息 及 该 设备 上 所 有 活动 的 应 用 
loadViewServerInfoAndWindows (device); 

} 

return; 

} 
f 


loadViewServerInfoAndWindows (device) ; 


n; 


这 段 代 码 告诉 我 们 几 件 事情 ， 如 下 。 





1) 首先 ， 要 做 端口 映射 。 








2) 其 次 ， 需 要 开启 ViewServer。 











3) 第 三 ， 获 取 该 设备 ViewServer 信 息 及 该 设备 上 所 有 活动 的 应 用 。 











BOr 的 重点 是 如 何 获取 设备 ViewServet 信 息 及 该 设备 上 所 有 活动 的 应 用 


所 以 ， 我 们 下 一 步 任 务 很 明晰 一 一 进入 到 loadViewServerlnfoAndWindows() 方 法 中 一 探究 竟 。 


10.2.7 ”获取 设备 应 用 信息 


废话 少 说 ， 进 入 到 HierarchyViewerDirectorjava 中 的 loadViewServerlnfoAndWindows() 方 法 ， 如 代码 清单 10-20 所 示 。 





代码 清单 10-20 HierarchyViewerDirector.java::loadViewServerlnfoAndWindows() 


private void loadViewServerInfoAndWindows (final IDevice device) ( 
// xuben: 获取 ViewServer 信 息 
ViewServerInfo viewServerInfo = DeviceBridge.loadViewServerInfo (device); 
if (viewServerInfo == null) ( 
return; 


l 

// xuben: 获取 设备 所 有 活动 的 应 用 

Window[] windows = DeviceBridge.loadWindows (device); 

// xuben: 通过 向 DeviceSelectionModel 添 加 设备 更 新 显示 

DeviceSelectionModel .getModel () .addDevice (device, windows, viewServerInfo); 

if (viewServerInfo.protocolVersion >= 3) { 
WindowUpdater.startListenForWindowChanges (HierarchyViewerDirector.this 

, device); 

focusChanged (device) ; 





7 DeviceBridge.loadWindows() 方法 又 是 如 何 获取 设备 所 有 活动 的 应 用 的 呢 ? 


B5, 你 将 找到 答案 ! 
继续 进入 到 该 方法 ， 如 代码 清单 10-21 所 示 。 


代码 清单 10-21 loadWindows() 





/* 
* This loads the list of windows from the specified device. The format is: 
* hashCodel titlel hashCode2 title2 http://www.hzcourse.com/resource/readBook?path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/... hashCodeN titleN DONE. 
* 
/ 
public static Window[] loadWindows (IDevice device) ( 
ArrayList<Window> windows = new ArrayList<Window>(); 
DeviceConnection connection = null; 
ViewServerInfo serverInfo = getViewServerInfo (device) ; 
try { 
// xuben: 建立 设备 连接 
connection = new DeviceConnection (device); 
// xuben: 发 送 "LIST" 命 令 给 ViewServer 
connection.sendCommand("LIST"); //$NON-NLS-1$ 
// xuben: 获取 返回 的 应 用 列表 
BuferedReader in = connection.getInputStream(); 
String line; 


while ((line = in.readLine()) != null) { 

if ("DONE.".equalsIgnoreCase(line)) ( //$NON-NLS-1$ 
break; 

} 

int index = line.indexOf(' '); 

if (index != -1) ( 
String windowId = line.substring(0, index); 
int id; 


if (serverInfo.serverVersion » 2) ( 

id = (int) Long.parseLong (windowId, 16); 
) else ( 

id = Integer.parseInt (windowId, 16); 


$ 

// xuben: 将 窗口 添加 到 窗口 列表 

Window w = new Window(device, line.substring(index + 1), id); 
windows . add (w) ; 


l 


l 
// xuben: 如 果 协 议 版 本 小 于 3， 则 需 显 式 指定 想 获得 焦点 的 窗口 
if (serverInfo.protocolVersion < 3) ( 

windows.add (Window.getFocusedWindow (device)); 


} 
} catch (Exception e) { 
Log.e (TAG, "Unable to load the window list from device " + device); 
} finally { 
if (connection != null) ( 
connection.close(); 


} 
} 
// xuben: 按 顶部 窗口 排 在 列表 最 上 端的 顺序 对 返回 的 windows 列 表 重 新 排列 


Window[] returnValue = new Window[windows.size()]; 

for (int i = windows.size() - 1; i >= 0; i--) { 
returnValue[returnValue.length - i - 1] = windows.get (i); 

} 


return returnValue; 





这 段 代 码 也 很 清楚 。 


1) 首先 ， 建 立 设备 连接 。 





2) EDR, Rik "LIST" 命令 给 ViewServer。 








3) 第 三 ， 获 取 返 回 的 应 用 列表 (以 window 形 式 ) 。 














4) 第 四 ， 将 窗口 添加 到 窗口 列表 。 























5) 最 后 ， 按 项 部 窗口 排 在 列表 最 上 端的 顺序 对 返回 的 Windows 列 表 重 新 排列 。 





人 5 获取 设备 应 用 信息 后 ， 接 下 来 ， 我 们 需要 获取 应 用 控件 的 层次 信息 。 


10.2.8 ”获取 应 用 控件 树 














与 获取 应 用 信息 类 似 ， 获 取 应 用 控件 层次 信息 对 应 的 方法 位 于 HierarchyViewerDirectorjava 中 的 loadViewHierarchy() 方 法 中 ， 如 代码 清单 10-22 所 示 。 

















代码 清单 10-22 HierarchyViewerDirector.java::loadViewHierarchy() 





public void loadViewHierarchy() { 
Window window = DeviceSelectionModel .getModel () .getSelectedWindow () ; 
if (window != null) { 
// xuben: i&itloadViewTreeData() 方法 获取 应 用 控件 层次 信息 
loadViewTreeData (window); 

















这 里 直接 调用 loadViewTreeData() 方 法 获取 应 用 控件 层次 信息 ， 继 续 进入 ， 如 代码 清单 10-23 所 示 。 








代码 清单 10-23 loadViewTreeData() 


public void loadViewTreeData (final Window window) { 
executeInBackground("Loading view hierarchy", new Runnable() ( 


GOverride 
public void run() { 


mFilterText = ""; //SNON-NLS-1$ 
// xuben: 核心 代码 ! 获取 控件 信息 
ViewNode viewNode = DeviceBridge.loadWindowData (window); 


if (viewNode !- null) 
// xuben: 遍历 ViewN' 


{ 
ode 树 ， 为 每 个 节点 加 载 ProfileData 信 息 


DeviceBridge.loadProfileData (window, eder 


// xuben: 遍历 ViewN 


ode 树 ， 计 算 每 个 子 树 所 包含 的 节点 数 


// 并 保存 在 ViewNode 的 viewCount 字 段 中 
viewNode.setViewCount (); 


// xuben: 设置 TreeViewModel 的 数据 源 ， 用 来 通知 监听 者 


// 设置 视图 


TreeViewModel.getModel().setData (window, viewNode) ; 





这 段 代 码 也 很 简单 ， 解 释 如 下 。 


1) 首先 ， 通 过 DeviceBridge.loadWindowpData() 方 法 获取 控件 信息 。 





2) 其 次 ， 遍 历 ViewNode 树 ， 为 每 个 节点 加 载 ProfileData 信 息 。 





3) 第 三 ， 遍 历 ViewNode 树 ， 计 算 每 个 子 树 所 包含 的 节点 数量 并 保存 在 ViewNode 的 viewCount 字 段 中 。 


4) 最 后 ， 设 置 TreeViewModel 的 数据 源 ， 

















来 通知 监听 者 设置 视图 ， 这 点 稍 后 详 述 。 





这 里 的 核心 自然 是 获取 控件 信息 方法 ， 继 续 进 入 到 该 方法 。 





获取 控件 信息 的 DeviceBridge.loadWindowData() 方 法 ， 如 代码 清单 10-24 所 示 。 


代码 清单 10-24 ”获取 控件 信息 





public static ViewNode loadWindowDa 
DeviceConnection connection = 
try { 
// xuben: 建立 设备 连接 


ta(Window window) { 
null; 


connection = new DeviceConnection (window.getDevice ()); 
// xuben: 发 送 "DUMP" 命 令 给 ViewServer 
connection.sendCommand("DUMP " + window.encode()); //$NON-NLS-1$ 


// xuben: 获取 返回 的 控件 列表 
BuferedReader in = connect 
ViewNode currentNode - nul 
int currentDepth = -1; 
String line; 


ion.getInputStream(); 
1; 


// xuben: 创建 控件 节点 树 ， 保 存在 ViewNode 对 象 中 


while ((line = in.readLine 


0) !2 null) ( 


if ("DONE.".equalsIgnoreCase (line)) { 


break; 


} 
int depth = 0; 


// xuben: 循环 读 取 空格 数 ， ETT 
while (line.charAt(depth) == ' ') 


deptht++; 


7 xuben: 通过 空格 数 ， 找 到 当前 节点 对 应 的 父 
while (depth <= currentDepth) ( 
currentNode - currentNode.parent; 


currentDepth--; 


} 


currentNode = new ViewNode (window, currentNode, 


currentDepth = depth; 
} 
if (currentNode — null) ( 
return null; 


l 
// xuben: 获取 顶层 节点 
while (currentNode.parent 


line.substring (depth)); 


t= null) ( 


currentNode - currentNode.parent; 


} 
ViewServerInfo serverInfo 
if (serverInfo !- null) { 


= getViewServerInfo (window.getDevice ()); 


currentNode.protocolVersion = serverInfo.protocolVersion; 


} 
return currentNode; 
] catch (Exception e) ( 


Log.e(TAG, "Unable to load window data for window " + window.getTitle() + " 


window.getDevice()); 


on device " 十 
Log.e(TAG, e.getMessage()); 
) finally ( 
if (connection != null) { 


connection.close(); 
} 
} 


return null; 


简单 地 说 ， 就 是 通过 发 送 “DUMP” 命 令 给 


b«c 这 里 通过 空格 数 ， 可 定位 到 当前 节点 的 父 节 点 ， 这 是 因为 ViewNode 树 中 的 节点 是 根据 节点 信息 前 面 


空格 的 最 近 节 点 为 该 节点 的 父 节点 。 





还 有 一 个 历史 遗留 问题 : Treeviewmodel.Getmode0.Setdata0 方 法 是 如 何 通 


ViewServer， 获 取 整 个 控件 树 并 保存 在 ViewNode 对 象 中 。 


eo, 好 记性 ! 带 着 这 个 问题 继续 挺进 吧 ! 


10.2.9 ”绘制 控件 树 视图 


进入 到 TreeViewModeljava 中 的 setData( 


) 方 法 ， 如 代码 清单 10-25 所 示 。 


代码 清单 10-25 TreeViewModel.java::setData() 


的 空格 确定 该 节点 的 层次 的 。 所 以 ， 该 节点 可 通过 


过 设置 Treeviewmodl 的 数据 源 来 通知 监听 者 设置 视图 的 ? 


空格 确定 深度 ， 并 可 确定 比 该 节点 少 一 





public void setData (Window window, ViewNode viewNode) { 
synchronized (this) ( 
if (mTree != null) ( 
mTree.viewNode.dispose(); 
} 


this.mWindow = window; 


if (viewNode == null) { 
mTree = null; 
) else ( 


// xuben: 通过 ViewNode 树 来 构造 DrawableViewNode 树 
mTree = new DrawableViewNode (viewNode); 

// xuben: 计算 每 个 节点 的 left 值 

mTree.setLeft (); 

// xuben: 计算 每 个 节点 的 top 值 

mTree.placeRoot (); 


I 

// xuben: 初始 化 视 见 区 
mViewport = null; 

// xuben: 初始 化 放大 缩小 比例 
mZoom = 1; 

// xuben: 初始 化 当前 选中 节点 
mSelectedNode = null; 


} 
// xuben: fh &treeChanged # + 
notifyTreeChanged () ; 





zB 


VÉ OUS ARIF IA, JR de DrawableViewNode ii it ViewNode4d£ £A P 44 LAER, RNA Aho 


上 


最 终 通过 触发 treeChanged 事 件 来 绘制 控件 树 视图 。 


继续 进入 notifyTreeChanged() 方 法 看 看 如 何 触发 ， 如 代码 清单 10-26 所 示 。 





代码 清单 10-26 notifyTreeChanged() 





public void notifyTreeChanged() ( 
// xuben: 调用 getTreeChangeListenerList 监 听 
ITreeChangelistener[] listeners = getTreeChangelistenerList (); 
if (listeners !- null) ( 
for (int i = 0; i < listeners.length; i++) { 
listeners[i].treeChanged(); 
l 








这 里 调用 getTreeChangeListenerList() 方 法 获取 监听 ， 继 续 进 入 ， 如 代码 清单 10-27 所 示 。 








代码 清单 10-27 getTreeChangeListenerList() 





private ITreeChangelistener[] getTreeChangeListenerList() { 

ITreeChangelistener[] listeners - null; 
synchronized (mTreeChangeListeners) { 

if (mTreeChangeListeners.size() — 0) ( 

return null; 
} 
listeners = mTreeChangeListeners.toArray (new 
ITreeChangeListener [mTreeChangeListeners.size()]); 


return listeners; 





放 入 到 mTreeChangeListeners 监 听 列 表 中 ， 而 该 监听 器 被 addTreeChangeListener() 方 法 添加 ， 如 代码 清单 10-28 所 示 。 


代码 清单 10-28 addTreeChangeListener() 





public void addTreeChangeListener (ITreeChangeListener listener) { 
synchronized (mTreeChangeListeners) { 
mTreeChangeListeners.add (listener); 


} 


这 个 监听 最 终 被 如 下 路 径 的 下 的 TreeViewer.java 和 TreeViewOverview.java 等 调用 : 


“~\sdk\hierarchyviewer2\libs\hierarchyviewerlib\src\com\android\hierarchyviewerlib\ui”， 如 代码 清单 10-29 所 示 。 


代码 清单 10-29 ”监听 调用 





public TreeViewOverview (Composite parent) ( 
super(parent, SWT.NONE); 
mModel = TreeViewModel.getModel () 7 
mModel.addTreeChangelistener (this); 
loadResources () ; 
addPaintListener (mPaintListener) ; 
addMouseListener (mMouseListener) ; 
addMouseMoveListener (mMouseMoveListener) ; 
addListener (SWT.Resize, mResizeListener) ; 
addDisposeListener (mDisposeListener) ; 
mTransform = new Transform(Display.getDefault ()); 
mInverse = new Transform(Display.getDefault ()); 
loadAllData(); 











通过 响应 treeChanged 事 件 ， 进 而 调用 PaintListener 事 件 ， 最 终 根据 TreeViewModel 中 的 mTree、mViewport、mZoom 和 mSelectedNode 的 数 








10.3 ”Instrumentation 的 原理 总 结 





全 人 还 有 个 小 问题 Instrumentation 是 通过 什么 方法 注入 事件 的 ? 


e Q 还 记得 monkey 是 通过 什么 方法 注入 事件 的 吗 ? 





多 如 果 没 记 错 的 话 ，monkey 通 过 WindowManager 的 finjectKeyEvent0 方 法 进行 事件 注入 。 











[ 


居 来 绘制 











| ONERE 方式 和 这 个 大 致 相同 。 





LAKE EA FF ADE? 
eo 首先 ， 通 过 WindowManaget 的 addView0 方 法 将 主 窗口 中 的 DecorView 添 加 到 WindowManager 中 ， 并 建立 会 话 ; 


© © JU, i8 i WindowManager 4) update ViewLayout( Zr 2k RAJS A 5 


最 后 ， 通 过 WindowManaget 的 removeView(0 方 法 来 移 除 窗口 。 





< 这 个 DecorView 又 是 什么 呢 ? 

= ees ， 即 是 主 窗口 中 的 顶级 view。 

E 

TUR 笑 我 啊 ，View 又 是 通过 什么 来 管理 的 呢 ? 

$9... 是 通过 ViewGroup 来 进行 管理 的 。 

& 

Som, RAT, MARMA Abit findViewById() F XE 2:5] LAH View, °C? 
eo 你 终于 开窍 了 ! 

& 

人 《WindowManagetr 和 ViewManaget 又 是 什 么 关系 呢 ? 

| CET 承 自 ViewManager， 主 要 用 来 管理 窗口 的 一 些 状态 、 必 性、 消息 收集 和 处 理 。 包 括 view 增 加 、 更 新 、 删 除 和 窗口 顺序 等 。 
es 

-人才 那么 addView0 方 法 又 是 如 何 将 主 窗口 中 的 DecorView 添 加 到 WindowManaget 中 的 呢 ? 


eo HA, addView( Zr i& iff i3 LayoutParams 3k £3 Window 89 View H ti. 
eo 其 次 ，addView0 方 法 为 每 个 Window 创 建 ViewRoot。 

最 后 ， 通 过 ViewRoot 的 setView0 方 法 把 View 传 递 给 WindowManager。 

E] 

从 哦 ， 这 样 看 来 ，ViewRoot 就 是 View 和 WindowManaget 之 间 的 纽带 啊 ! 


ee, 可 以 这 么 说 ! 


Vel. C te gef REACT, ACE LL nstrumentation foo 8) 3L XH HH HA o? 难道 不 打算 给 大 家 综述 一 下 ? 


eo. 马上 开始 ! 


Instrumentation 最 核心 的 就 是 对 控件 的 捕获 ， 因 为 捕获 控件 后 ， 剩 下 的 就 是 对 控件 的 操作 ， 而 Instrumentation 对 控件 的 操作 与 Android 原 生 操作 保持 一 致 。 所 以 ， 我 们 寻 
Instrumentation 是 如 何 对 控件 进行 捕获 的 。 








Lu] 
Ir 


分 析 一 下 











根据 之 前 的 分 析 ， 我 们 知道 ，Instrumentation 控 件 捕获 大 致 分 为 如 下 几 个 步骤 ， 如 图 10-8 所 示 。 













—^ 1. 启动 adb + 


2. 设 置 adb 
程序 位 置 


一 一 。 3. 连 接 View Server + 


——— 4 .获取 活动 的 Activities © 


— 5 获取 Activity 的 控件 树 e 


一 。 6 获取 控件 截图 © 











10-8 Instrumentation 控 件 捕获 概况 





全 人 首先 是 启动 atb。 





首先 是 启动 adb， 如 图 10-9 所 示 。 


s 1 启动 adb = 通过 adb devices 获 取 连 接 设 备 














图 10-9 È adb 
-从 接 下 来 是 设置 db 程序 位 置 。 


接 下 来 是 设置 adb 程 序 位 置 ， 如 图 10-10 所 示 。 


说 明 : 对 应 Hierarchyviewer 运 行 准备 

















c 2 设置 adb |.) 实现 : hierarchyviewer.adb 路 径 ， 如 巴 哥 奔 的 
Ss System.setProperty("hierarchyviewer.adb","D:\\xuben\\android-sdk-windows4.2\\tools*) 
图 10-10 ”设置 adb 程 序 位 置 
XH EE iEdkView Server. 





第 三 是 连接 View Server， 大 致 分 为 3 项 ， 如 图 10-11 所 示 。 











”1 设备 识别 4 
一 * 3. 连 接 View Server S512. 开启 ViewServer 服 务 t 
3. 连 接 View Server * 


图 10-11 连接 View Server 


对 每 一 项 进行 详细 分 析 ， 如 图 10-12 所 示 。 





说 明 : 对 应 Hierarchyviewer 启 动 


映射 4939 端 口 : 
1. 设 备 识别 S adb -s emulator-5556 forward tcp:4939 tcp:4939 


devices = DeviceBridge.getDevices() ; 
一 -*。 3, 连 接 View Server Pl adb -s emulator-5556 shell service call window 1 i32 4939 
2. 开 启 ViewServer 服 务 S DeviceBridge.startViewServer(device); 
说 明 : 对 应 Hierarchyviewer 的 Start Server 


i 通过 socket 连 接 : 
.连接 V > 
SV Sever socket.connect(new InetSocketAddress("127.0.0.1", 4939),40000); 














图 10-12 ”连接 View Serveri# 4a FAT 


s» 
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第 四 是 获取 活动 的 Activities， 如 图 10-13 所 示 。 




















说 明 : Hierarchyviewer 的 Load View Hierarchy 


—* 4. 获取 ; Activities © 
获取 活动 的 "'ViewHierarchyLoader.loadScene(device, Window.FOCUSED WINDOW) ; 











图 10-13 ”获取 活动 的 Activity 





-人 性 第 五 是 获取 Activity 的 控件 树 。 








第 五 是 获取 Activity 的 控件 树 ， 大 致 分 为 两 项 ， 如 图 10-14 所 示 。 








1 .获取 控件 树 根 节点 & 


e 5. 获 取 Activity 的 控件 树 m 2. 获 取 控 件 子 节点 《 














10-14 ”获取 Activity 的 控件 树 





对 每 一 项 详细 分 析 ， 如 图 10-15 所 示 。 





说 明 : 对 应 Hierarchyviewer 的 控件 树 根 节点 
1 获取 控件 树 根 节点 调用 ViewHierarchyScene 对 象 vhs 的 getRoot() 方 法 
* 5. 获取 Activity 的 控件 树 = 说 明 : 对 应 Hierarchyviewer 的 控件 子 节点 
通过 findFirstChildrenElement() 方 法 
2 Ho 
iii 通过 "DUMP <Activity 的 hash code>” 获 取 控 件 树 


10-15. 获取 Activity 的 控件 树 详细 分 析 























s» 
SRS Rue HAR 

















最 后 是 获取 控件 截图 ， 如 图 10-16 所 示 。 





o 








eit "CAPTURE 
6 .获取 控件 截图 上 <Activity 的 hashcode> + "G" + < 控件 的 hashcode>” 获 取 控 件 截图 





图 10-16 ”获取 控件 截图 














s» 
人 综合 起 来 如 图 。 














综合 起 来 ， 如 图 10-17 所 示 。 








通过 adb 


一 4. 启动 adb - devices 获 取 连 接 设 备 
Pi í 说 明 : 对 应 Hierarchyviewer 运 行 准备 
_, 2. 设置 adb _ SCH : hierarchyvieweradb 路 径 ， 如 巴 哥 弃 的 
/ | 程序 位 置 System.setProperty("hierarchyviewer.adb"," 


DAWwubenWandroid-sdk-windows4.2Wtools") 


说 明 : 对 应 Hierarchyviewer 启 动 
映射 4939 端 口 : 
1. 设 备 识别 Siadb -s emulator-5556 forward tcp:4939 tcp:4939 


devices = DeviceBridge.getDevices() ; 









adb -s emulator-5556 shell service call 
pe 3. 连 接 View Server = window 1 i32 4939 


/ 2. 开 启 ViewServer 服 务 s DeviceBridge.startViewServer(device); 


说 明 : 对 应 Hierarchyviewer 的 Start 
Server 


i _| 通过 socket 连 接 : socket.connect(new 
esever InetSocketAddress('127.0.0.1" 4939),40000); 
说 明 : Hierarchyviewer 的 Load View 


-— Hierarchy 
4 获取 活动 的 Activities ||. ViewHierarchyLoader.loadScene 


(device, Window.FOCUSED WINDOW) ; 


-— 
A 








说 明 : 对 应 Hierarchyviewer 的 控件 树 根 节点 
1. 获 取 控件 树 根 节 点 引 调用 ViewHierarchyScene 对 象 vhs 的 getRoot() 方 法 


J 5 获取 Activity 的 控件 树 上 说 明 : 对 应 Hierarchyviewer 的 控件 子 节点 
通过 findFirstChildrenElement() 方 法 
2. 获 取 控 件 子 节点 引 通 过 “DUMP <Activity 的 hash 
code>” 获 取 控 件 树 





| ^ 通过 "CAPTURE 
“6 获取 控件 截图 - <Activity 的 hashcode>+“@”+< 控 件 的 hashcode>” 获 取 控 件 截图 


图 10-17 ”Instrumentation 控 件 捕 获 


i» 
人 《看 上 去 很 复杂 的 样子 ， 具 体 一 个 按键 事件 的 往返 流程 是 怎样 的 ? 


2°... 且 泡 杯 咖啡 ， 静 静 听 我 分 析 。 


按键 事件 往返 流程 ， 如 图 10-18 所 示 。 





控件 识别 “= 设备 通过 DUMP 命 令 将 控件 信息 发 送 给 PC 


按键 转换 o 当 用 户 进行 点 击 等 按键 操作 后 ， 该 操作 将 转换 成 对 应 的 KeyCode 








| 按键 发 送 ”S 通过 Instrumentation 发 送 该 按键 事件 





(meg o 当 按 键 事件 通过 Socket 下 达 后 ， 该 事件 将 被 传递 给 循环 监听 程序 
| ete 监听 程序 六 事件 通过 Service 传 弟 给 后 台 ,由 后 台 进 行 处 理 


| 系统 反馈 o 系统 将 后 台 处 理 信息 通过 Emulator 反 馈 给 用 户 


图 10-18 ”按键 事件 往返 流程 


这 下 彻底 清楚 了 ! 


$3118 UIAutomator 原 理 分 析 


J| 
4 完 Instrumentation 的 原理 后 ， 最 想 进行 对 比分 析 的 就 是 UIAutomator 了 1! 


11.1 ”UIAutomator 源 码 结构 


UlAutomator 在 “~\frameworks\testing\uiautomator\library\src\com\android\uiautomator” 目 录 下 ， 其 源码 树 如 图 11-1 所 示 。 


Accessibilit yNodeInfoDumper. java 
Accessibilit yNodeInfoHelper. java 
Interact ionController. java 
QueryController.java 

Tracer. java 
UifhutomatorBridge. java 


UiCollection. java 
UiDdevice.java 

UiOhbject.java 

Ui0bjectNot FoundException. java 
UiScrollable.java 
UiSelector. java 

UiWvatcher. java 


estrunner 
IAutomat ionSupport .java 
TestCaseCollector. java 
UVihutomatorlestCase. java 
UifAutomatorTestCaseFilter.java 
UihutomatorTestRunner. java 


图 11-1 ”UIAutomatot 源 码 树 





11.2 ”UIAutomator 架 构 分 析 


eo 还 记得 咱们 用 UIAutomator 完 成 的 那个 项 目 吗 ? 





5 
全 必 当 然 记 得 ， 那 可 是 咱们 的 经 典 之 作 ，UIAutomator 完 成 的 bugben 测 试 项 目 ， 参 见 5.6.5 节 。 


Bern 目 回顾 下 来 ， 你 觉得 有 哪些 点 值得 一 说 ? 


等， 
人 《还 蛮 多 的 ， 我 整理 了 一 下 ， 一 起 看 看 ! 
值得 回味 的 方法 包括 如 下 几 个 方面 。 


(1) 控件 捕获 (获取 文本 方式 ) 





UiSelector () .text ("4t zx") 





(2) 将 控件 创建 为 UiObject 对 象 





UiObject subbutton = new UiObject (new UiSelector () .text (" 提 交 ") ) 





(3) 验证 控件 是 否 存在 





Subbutton.exists () 





(4) 验证 控件 是 否 可 用 





subbutton.isEnabled() 





(5) 控件 点 击 并 等 待 界面 跳 转 





subbutton.clickAndWaitForNewWindow () 





(6) 获取 屏幕 截图 











UiDevice.getInstance () .takeScreenshot (displayPicFile) ; 








(7) 发 送 返 回 事件 





UiDevice.getInstance().pressBack(); 





eo. ua. LF 3c4& Y 3E/-UlAutomatorfig Ks Zr ik, "841—442 MEE! 


11.2.1 控件 捕获 





首先 来 看 看 控件 捕获 (获取 文本 方式 ) 。 




















UiSelector() .text () 





进入 到 UiSelector.java， 如 代码 清单 11-1 所 示 。 


代码 清单 11-1 ”控件 捕获 





// xuben: 获取 控件 文本 方法 ， 添 加 了 一 个 SELECTOR_TEXT 标 签 后 
// 传 给 buildSelector () 进行 统一 处 理 
public UiSelector text (String text) { 
return buildSelector(SELECTOR TEXT, text); 
} 





来 看 看 buildSelector() 方 法 是 如 何 处 理 的 ， 如 代码 清单 11-2 所 示 。 


代码 清单 11-2  buildSelector() 





private UiSelector buildSelector(int selectorId, Object selectorValue) { 
UiSelector selector = new UiSelector (this); 
if (selectorId == SELECTOR CHILD || selectorId == SELECTOR PARENT) 
selector.getLastSubSelector 0 .mSelectorAttributes.put (selectorId, selectorValue); 
else 
selector.mSelectorAttributes.put (selectorId, selectorValue); 
return selector; 























这 段 代码 判断 UiSelector 是 否 通 过 子 节点 / 父 节点 的 方法 进行 控件 查找 ， 是 则 调用 getLastSubSelector() 方 法 并 存 入 mSelectorAttributes， 否 则 直接 存 入 mSelectorAttributes， 无 论 是 否 都 将 返回 
新 的 selector 对 象 。 


























5 那么 ， 这 个 mSelectorAtttibutes 是 用 来 干 嘛 的 呢 ? 


$5, i. 咱们 继续 往 下 看 ， 慢 慢 就 会 水 落石 出 。 


11.2.2 


创建 UiObject 对 象 


将 控件 创建 为 UiObject 对 象 ， 方 法 如 下 。 





UiObject subbutton = new UiObject (new UiSelector () .text (" 提 交 ") ) 


进入 到 对 象 创建 ， 如 代码 清单 11-3 所 示 。 





代码 清单 11-3 ”对 象 创建 





public UiObject(UiSelector selector) { 


// xuben: i&itUiDevicefjgetAutomatorBridge () 创 建 

// UikutomatorBridgext ¥mUiAutomationBridge 

mUiAutomationBridge = UiDevice.getInstance () .getAutomatorBridge () ; 
// xuben: 将 返回 的 selector mSelector 

mSelector = selector; 








3x 4 3€ 64 UiAutomatorBridge X. Æ -T- "f Jf] 65 YE? 


| CRM 


小 插曲 1: 控件 捕获 和 操作 基本 原理 


通过 UiDevice.getinstance().getAutomatorBridge() 方 法 返回 





UiAutomatorBridge 的 对 象 mUiAutomationBridge， 如 下 。 





UiAutomatorBridge getAutomatorBridge() ( 


} 


£o 


< 


return mUiAutomationBridge; 


$9... 


UiAutomatorBridge 继 承 自 UiTestAutomationBridge， 作 为 UiAutomator 测 试 框架 的 基础 ，UiTestAutomationBridge 通 过 AccessibilityNodelnfo 捕 获 界面 组 件 节点 (这 也 是 UIAutomtorViewer 

















示 节 点 树 的 基础 ) ， 并 通过 AccessibilityEvent 对 界面 UI 元 素 进行 操作 。 


CT? UiAutomatorBridge， 和 monkeyrunner 所 调用 的 AndroidDebugBridge 是 不 是 一 个 东西 ? 


9o, 了 捕获 节点 、 操 作 节 点 这 两 大 基础 ，UiAutomatorBridge 在 它 父 类 的 基础 上 继续 发 扬 光 大 。 


对 应 代码 如 代码 清单 11-4 所 示 。 





代码 清单 11-4 ”通过 UiAutomatorBridge 获 取 界 面 或 进行 事件 注入 





展 





// xuben: 创建 AccessibilityEvent 监 听 器 
public interface AccessibilityEventListener { 


} 


public void onAccessibilityEvent (AccessibilityEvent event); 


// xuben: UidutomatorBridget)ié Hak, Alt 
// InteractionController#=QueryControllerst} $- 
UiAutomatorBridge() { 


$ 


mInteractionController = new InteractionController (this); 
mQueryController = new QueryController (this); 
connect () ; 


// xuben: i&idgetInteractionController () 获取 InteractionController 对 象 
InteractionController getInteractionController() ( 


return mInteractionController; 


l 
// xuben: 通过 getQueryController () 获取 QueryController 对 象 
QueryController getQueryController() ( 


} 


return mQueryController; 














UiAutomator 通 过 UiAutomatorBridge 获 取 界 面 或 进行 事件 注入 。 


对 节点 的 捕获 和 操作 详细 说 明 如 下 。 


1) 捕获 : 通过 QueryController 将 UiSelector 查 找到 的 信息 解析 为 AccessibilityNodelnfo (如 
getLastTraversedText() 等 均 出 于 此 ) 。 


2) 操作 : 通过 interactionController 对 控件 操作 进行 细 分 (如 点 击 、 拖 搜 、 滑 动 和 按 下 等 ， 包 括 前 面 项 目 例子 中 的 “点 击 并 等 待 新 窗口 打开 ”方法 clickAndWaitForNewWindow0 均 出 于 此 ) 。 








eo 了 解 控件 捕获 和 操作 的 基本 原理 后 ， 接 下 来 ， 咱 们 就 可 以 看 看 如 何 验证 控件 是 否 存 在 。 


11.23 


验证 控件 是 否 存在 





“节点 查 


找 ” 方 法 findAccessibilityNodelnfo(getSelector())， 


通过 Uiselector(.text() 方 法 找到 控件 后 ， 需 要 将 其 存 为 UiObject 对 象 (此 处 为 subbutton) 。 接 下 来 ， 就 要 验证 该 对 象 是 否 存在 ， 如 代码 清单 11-5 所 示 。 


代码 清单 11-5 ”获取 控件 


“获取 上 次 输入 文本 ”方法 





// xuben: 通过 waitForExists() 获取 控件 
public boolean exists() { 


Tracer.trace(); 
return waitForExists (0); 





而 waitForExists() 方 法 则 调用 findAccessibilityNodelnfo() 方 法 进行 判断 ， 如 代码 清香 


代码 清单 11-6 waitForExists() 


E11-6 所 示 。 








public boolean waitForExists (long timeout) ( 
Tracer.trace (timeout); 
if(findAccessibilityNodeInfo (timeout) != null) { 
return true; 
} 


return false; 





不 难 发 现 ，findAccessibilityNodelnfo() 方 法 是 通过 getQueryController(0.findAccessibilityNodelnfo(getSelector()) 方 法 进 : 


代码 清单 11-7 ”查找 对 应 的 控件 信息 


了 一 二 


fr» 


点 查找 对 应 的 控件 信息 ， 如 代码 清和 


E11-7 所 示 。 








protected AccessibilityNodeInfo findAccessibilityNodeInfo(long timeout) { 

AccessibilityNodeInfo node - null; 
if (UiDevice.getInstance() .isInWatcherContext()) ( 

// xuben: 检查 设备 是 否 存在 watcher， 如 果 存 在 ， 

// 直接 通过 findAccessibilityNodeInfo() 获取 节点 信息 

node = getQueryController ().findAccessibilityNodeInfo (getSelector ()); 
} else { 

// xuben: 若 此 时 设备 没有 watcher， 通 过 findAccessibilityNodeInfo() 获 取 

// 控件 信息 后 ， 将 检查 该 节点 是 否 为 空 

long startMills = SystemClock.uptimeMillis(); 

long currentMills - 0; 

while(currentMills <= timeout) { 

node = getQueryController ().findAccessibilityNodeInfo (getSelector ()); 





if(node != null) ( 
// xuben: 若 该 节点 非 空 ， 则 跳出 循环 ， 直 接 返 回 该 节点 
break; 

) else ( 


// xuben: 车 该 节点 为 空 ， 则 通过 runWatchers () 运 行 watcher 
UiDevice.getInstance ().runWatchers(); 

} 

currentMills = SystemClock.uptimeMillis() - startMills; 

if(timeout > 0) { 
SystemClock.sleep(WAIT FOR SELECTOR POLL); 

} 

} 


return node; 


} 





$9,.., 次 验证 了 小 插曲 1 中 的 说 明 一 一 通过 QueryController 将 UiSelector 查 找到 的 控件 信息 解析 为 AccessibilityNodeInfo。 
下 面 一 起 来 看 看 findAccessibilityNodelnfo(getSelector()) 方 法 是 如 何 工作 的 吧 ! 
小 插曲 2: 解析 UiSelector 控 件 信 息 


QueryController 的 findAccessibilityNodelnfo() 方 法 如 代码 清单 11-8 所 示 。 





代码 清单 11-8 findAccessibilityNodelnfo() 





public AccessibilityNodeInfo findAccessibilityNodeInfo(UiSelector selector) { 
return findAccessibilityNodeInfo (selector, false); 
} 
protected AccessibilityNodeInfo findAccessibilityNodeInfo (ViSelector selector, 
boolean isCounting) ( 
// xuben: 通过 UiAutomatorBridge 进 行 空闲 等 待 
mUiAutomatorBridge.waitForldle(); 
// xuben: 初始 化 查找 ， 如 将 mPatternCounter 等 重 置 为 0 
initializeNewSearch(); 
if (DEBUG) 
Log.d(LOG TAG, "Searching: " + selector); 
synchronized (mLock) { 
// xuben: 获取 控件 树 根 节点 
AccessibilityNodeInfo rootNode = getRootNode () ; 
if(rootNode == null) { 
Log.e(LOG TAG, "Cannot proceed when root node is null. Aborted search"); 
return null; 


l 

// xuben: 创建 UiSelector 对 象 并 传 入 捕获 到 的 selector 

UiSelector uiSelector = new UiSelector (selector); 

// xuben: 调用 translateCompoundSelector () 方法 将 UiSelector 

// 查找 到 的 信息 解析 为 AccessibilityNodeInfo 

return translateCompoundSelector (uiSelector, rootNode, isCounting); 





具体 步骤 如 下 。 


A 


空闲 等 待 : 通过 UiAutomatorBridge 进 行 空闲 等 待 。 





T 


2) 初始 化 查找 : 如 将 mPatternCounter 等 重 置 为 0。 


Ww 


获取 根 节 点 : 通过 getRootNode() 方 法 获取 控件 树 根 节点 。 


4) 创建 UiSelector: 创建 UiSelector 对 象 并 传 入 捕获 到 的 selector。 














5) 解析 信息 : 调用 translateCompoundSelector() 方 法 将 UiSelector 查 找到 的 信息 解析 为 AccessibilityNodelnfo。 











全 看 来 translateCompoundSelector0 方 法 是 重点 ， 继 续 跟 进 ! 


小 插曲 3: 获取 控件 树 根 节点 
QueryController 的 translateCompoundselector() 方 法 如 代码 清单 11-9 所 示 。 


代码 清单 11-9 translateCompoundSelector() 





private AccessibilityNodeInfo translateCompoundSelector (UiSelector selector, 
AccessibilityNodeInfo fromNode, boolean isCounting) ( 
// xuben: 先 查 看 是 否 存在 Container selector 
if (selector.hasContainerSelector () ) 
// xuben: 再 查看 是 否 存在 多 重 嵌 套 的 selectors 
if(selector.getContainerSelector().hasContainerSelector()) { 
// xuben: 通过 调用 ranslateCompoundSelector () 找 到 多 重典 套 的 节点 
fromNode = translateCompoundSelector ( 
selector.getContainerSelector(), fromNode, false); 
initializeNewSearch(); 
} else 


// xuben: 通过 调用 translateReqularSelector() 处 理 regular selectors 
// 类 型 的 selector， 此 处 由 于 还 有 一 层 庶 套 ， 
// 所 以 传 入 selector.getContainerSelector () 
fromNode = translateReqularSelector (selector.getContainerSelector(), fromNode); 
else 
// xuben: 没有 内 套 的 直接 传 入 Selector 进 行 解析 
fromNode = translateReqularSelector (selector, fromNode); 
// xuben: 若 未 找到 节点 ， 则 返回 nul1 
if(fromNode — null) ( 
if (DEBUG) 
Log.d(LOG_ TAG, "Container selector not found: " + selector.dumpToString (false) ); 
return null; — 


l 
// xuben: 若 selector 包 含 的 是 pattern _ selectors 类 型 ， 则 调用 
// translatePatternSelector () 进行 解析 
if(selector.hasPatternSelector()) { 
fromNode = translatePatternSelector (selector.getPatternSelector(), 
fromNode, isCounting); 
// xuben: Pattern_selectors 类 型 可 对 UI 对 象 进行 计数 
if(isCounting) ( 
Log.i(LOG TAG, String.format( 
"Counted £d instances of: $s", mPatternCounter, selector)); 
return null; 
} eise { 
if(fromNode == null) { 
if (DEBUG) 
Log.d(LOG TAG, "Pattern selector not found: " + 
selector. dumpToString (false) ); 
return null; 


} 


} 
// xuben: ”车 测 试 脚本 通过 getChild() 等 方法 ， 即 selector 具 有 子 节点 
// 或 父 节点 的 情况 ， 也 需要 通过 translateReqularSelector () 进行 处 理 
if(selector.hasContainerSelector() || selector.hasPatternSelector()) { 
if(selector.hasChildSelector() || selector.hasParentSelector () ) 
fromNode = translateReqularSelector (selector, fromNode) ; 
l 
if(fromNode — null) ( 
if (DEBUG) 
Log.d(LOG_TAG, "Object Not Found for selector " + selector); 
return null; 


Log.i(LOG TAG, String.format ("Matched selector: %s <<==>> [%s]", selector, fromNode) ) 7 
return fromNode; 


具体 步骤 如 下 。 





A 


先 查 看 是 否 存 在 Contafiner selector, 
“ 若 存在 Contafiner selector， 再 查看 是 否 存 在 多 重 褒 套 的 selectors。 
“ 若 存 在 ， 则 通过 调用 translateCompoundSelector0 找 到 多 重 诬 套 的 节点 。 
“ 若 不 存在 多 重 庶 套 的 selectors， 则 通过 调用 translateRequlatSelector0 方 法 处 理 regular_selectors 类 型 的 selector， 此 处 由 于 还 有 一 层 谋 套 ， 所 以 传 入 selector.getContafinerSelector0 方 法 。 
“ 若 不 存在 Contafiner selector, LAMBA WAL Aselectoriet 17 MF HT o 
2) 若 未 找到 节点 ， 则 返回 null。 
3) 若 selector 包 含 的 是 pattern_selectors 类 型 ， 则 调用 translatePatternSelector() 方 法 进行 解析 。 


4) pattern_selectors 类 型 可 对 UI 对 象 进行 计数 。 




















5) 若 测 试 脚本 通过 getChild0 等 方法 ， 即 selector 具 有 子 节点 或 父 节点 的 情况 ， 也 需要 通过 translateReqularSelector() 方 法 进行 处 理 。 























通过 对 代码 的 分 析 ， 我 们 发 现 ， 调 用 translateCompoundSelector() 方 法 根据 用 户 指 定 的 UiSelector 格 式 获得 根 节点 ， 进 而 对 控件 树 进行 遍历 以 捕获 目标 控件 。 





















AURA, selector 18248 $ H? 
eo. ,. 一 起 来 看 看 吧 ! 
selector 分 为 如 下 几 种 。 


1) regular selector, BPBy[attributeshttp://www.hzcourse.com/resource/readBook? 
path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/...CHILD- By[attributeshttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15501/OEBPS/Text/...CHILD=By[http://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15501/OEBPS/Text/..http://www.hzcourse.com/resource/readBook? 


path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/..]]]. 


2) pattern selector, BDhttp://www.hzcourse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/15501/OEBPS/Text/...CONTAfinER=By[http://www.hzcourse.com/resource/readBook? 
path-/openresources/teach ebook/uncompressed/15501/OEBPS/Text/..] PATTERN =By[instance=x PATTERN- [regular selector], 


3) compound selector， 即 以 上 两 种 的 组 合 : [regular selector[pattern selector]]. 















































其 中 ，regular_selectors 比 较 通 用 和 直接 ， 而 pattern_selector 不 仅 需 要 找到 控件 属性 ， 还 将 遍历 整个 节点 数 ， 也 正 因为 如 此 ，pattern_selector 能 够 返回 计数 。 

















下 面 我 们 以 较为 通用 的 regular_selectors 为 例 ， 看 看 translateReqularSelector() 方 法 究竟 干 了 些 什么 ! 














小 插曲 4: 遍历 控件 树 


QueryController 的 translateReqularSelector() 方 法 如 下 ， 如 代码 清单 11-10 所 示 。 


代码 清单 11-10 translateReqularSelector() 





private AccessibilityNodeInfo translateReqularSelector (UiSelector selector, 
AccessibilityNodeInfo fromNode) { 
// xuben: 直接 通过 findNodeRegularRecursive () 进行 解析 
return findNodeRegularRecursive (selector, fromNode, 0); 





喻 都 不 说 了 ， 直 接 进 入 findNodeRegularRecursive() 方 法 看 个 究竟 ， 如 代码 清单 11-11 所 示 。 


代码 清单 11-11 findNodeRegularRecursive() 





private AccessibilityNodeInfo findNodeRegularRecursive (UiSelector subSelector, AccessibilityNodeInfo fromNode, int index) ( 
// xuben: 先 判断 Selector 的 根 节点 与 index 是 否 匹 配 
if (subSelector.isMatchFor(fromNode, index)) ( 


if (DEBUG) ( 
Log.d(LOG TAG, 


formatLog (String. format ("$s", 


subSelector.dumpToString (false) ))); 


} 


// xuben: 若 selector 已 经 为 叶子 节点 ， 则 直接 返回 该 节点 
if(subSelector.isLeaf()) { 
return fromNode; 


} 
// xuben: 若 还 有 存在 下 一 个 selector， 则 定位 到 下 一 个 selector， 否 则 若 存 在 


// 上 一 个 selector 


则 返回 上 一 个 selector 并 将 节点 返回 到 父 节 点 


if(subSelector.hasChildSelector()) ( 
mLogIndent++; // next selector 
subSelector = subSelector.getChildSelector(); 


if (subSelector 


= null) { 


Log.e(LOG TAG, "Error: A child selector without content"); 


return null; 


// there is an implementation fault 


} 

} else if(subSelector.hasParentSelector()) { 
mLogIndent++; // next selector 
subSelector = subSelector.getParentSelector (); 


if (subSelector 


= null) { 


Log.e(LOG TAG, "Error: A parent selector without content"); 


return null; 


// there is an implementation fault 


I 
// xuben: 因为 selector 返 回 到 上 一 个 selector， 所 以 节点 也 需要 返回 到 父 节 点 
fromNode = fromNode.getParent (); 


if(fromNode == 
return null; 


} 


l 
// xuben: 获取 当前 节 


null) 


点 的 子 节点 数 


int childCount = fromNode.getChildCount (); 
boolean hasNullChild - false; 
// xuben: 循环 遍历 子 节点 ， 并 通过 findNodeRegularRecursive () 进行 递归 
for (int i = 0; i « childCount; i++) { 
AccessibilityNodeInfo childNode = fromNode.getChild (i); 


if (childNode == 
Log.w(LOG TAG, 


null) ( 
String.format( 


"AccessibilityNodeInfo returned a null child ($d of $d)", i, childCount)); 
if (!hasNullChild) ( 
Log.w(LOG TAG, String.format("parent = %s", fromNode.toString())); 


} 
hasNullChild = 
continue; 


} 


true; 


if (!childNode.isVisibleToUser()) { 


if (VERBOSE) 


Log.v(LOG TAG, 
String.format("Skipping invisible child: %s", childNode.toString())); 


continue; 


} 


// xuben: i&itfindNodeRegularRecursive () 进 行 递归 ， 直 到 找到 该 节点 
AccessibilityNodeInfo retNode = findNodeRegularRecursive (subSelector, childNode, i); 
if (retNode !- null) ( 

return retNode; 


} 
f 
return null; 


} 








具体 步骤 如 下 。 





1) 根 节点 匹配 : 先 判断 Selector 的 根 节点 与 index 是 否 匹 配 。 


' 著 selector 已 经 为 叶子 节点 ， 则 直接 返回 该 节点 。 


- 著 还 有 存在 下 一 个 selector， 则 定位 到 下 一 个 selector。 


- 否则 车 存在 上 一 个 selector 则 返回 上 一 个 selector 并 将 节点 返回 到 父 节点 。 因 为 selector 返 回 到 上 一 个 selector， 所 以 节点 也 需要 返回 到 父 节点 。 


2) 获取 子 节点 数 : 通过 getChildCount0 方 法 获取 当前 节点 的 子 节点 数 。 


3) 遍历 子 节点 : 循环 遍历 子 节点 ， 并 通过 findNodeRegularRecursive() 方 法 进行 递 妥 ， 直 到 找到 该 节点 。 


到 此 为 止 ， 我 们 大 体 明白 

















了 findAccessibilityNodelnfo(getSelector()) 方 法 是 如 何 将 UiSelector 查 找到 的 信息 解析 为 AccessibilityNodelnfo 对 象 的， 解析 后 的 节点 retNode， 可 上 


Se, KARET! 原来 是 这 样 找到 目标 节点 的 ! 


e. 容易 吧 ? 下 面 来 看 看 如 何 验证 控件 是 否 可 用 。 


11.24 ”验证 控件 是 否 可 用 








验证 控件 存在 后 ， 接 下 来 就 要 验证 控件 是 否 可 用 ， 方 法 如 下 。 




















于 下 一 步 的 使 用 








subbutton.isEnabled() 





对 应 代码 如 代码 清单 11-12 所 示 。 


代码 清单 11-12 ”验证 控件 是 否 可 用 





public boolean isEnabled() throws UiObjectNotFoundException { 


Tracer.trace(); 


AccessibilityNodeInfo node = findAccessibilityNodeInfo(WAIT FOR SELECTOR TIMEOUT); 


if(node == null) { 


throw new UiObjectNotFoundException (getSelector ().toString()); 


return node.isEnabled(); 





= 包含 了 对 控件 是 否 存在 的 检查 ， 只 不 过 这 里 检查 出 控件 不 存在 的 话 ， 将 不 是 返回 fse， 而 是 直接 抛 异常 。 若 控件 存在 ， 则 调用 isEnabled0 方 法 判断 其 是 否 可 用 。 


11.2.5 ”点 击 并 等 待 界面 跳 转 


控件 点 击 并 等 待 界面 跳 转 ， 方 法 如 下 。 





subbutton.clickAndWaitForNewWindow () 





继续 进入 UiObjectjava， 如 代码 清单 11-13 所 示 。 


代码 清单 11-13 UiObject.java::clickAndWaitForNewWindow() 





UiObject.java::clickAndWaitForNewWindow () 
public boolean clickAndWaitForNewWindow() throws UiObjectNotFoundException ( 
Tracer.trace(); 
// xuben: 通过 调用 clickAndWaitForNewWindow () 
return clickAndWaitForNewWindow(WAIT FOR WINDOW TMEOUT); 
$ 





进入 clickAndWaitForNewWindow() 方 法 ， 如 代码 清单 11-14 所 示 。 


代码 清单 11-14 clickAndWaitForNewWindow() 





public boolean clickAndWaitForNewWindow(long timeout) throws UiObjectNotFoundException { 
Tracer.trace (timeout); 
// xuben: 这 里 再 次 检查 节点 是 否 存在 ， 
// 不 存在 即 抛 UiObjectNotFoundException 异 常 
AccessibilityNodeInfo node = findAccessibilityNodeInfo (WAIT FOR SELECTOR TIMEOUT); 
if(node == null) { = z 
throw new UiObjectNotFoundException (getSelector () .toString()); 


l 

// xuben: i&itgetVisibleBounds () 获取 控件 的 可 见 边界 

Rect rect = getVisibleBounds (node); 

// xuben: 调用 InteractionController 的 clickAndWaitForNewWindow () 进行 点 击 

return getInteractionController ().clickAndWaitForNewWindow ( 
rect.centerX(), rect.centerY(), timeout); 





模糊 的 景象 慢 慢 清晰 ， 情 况 开始 变 得 有 意思 起 来 一 一 获取 控件 可 见 边界 ， 并 对 Interaction-Controller 的 clickAndWaitForNewWindow() 方 法 传 入 类 似 坐标 点 的 参数 


(rect.centerX(),rect.centerY()) 。 








有 这 是 通过 坐标 进行 点 击 的 节奏 吗 ? 如 果 是 这 样 ，UIAutomator 整 个 框架 就 更 清晰 了 一 些 。 


Orn, 通过 传 入 绝对 坐标 〈 即 直接 通过 坐标 进行 操作 的 方式 ) 或 相对 坐标 〈 即 通过 文本 、 描 述 和 索引 等 方式 找到 控件 后 ， 确 定 当前 控件 的 坐标 点 ) 对 控件 进行 操作 。 


Jin} 





有 实 上 ， 几 乎 所 有 自动 化 框架 都 是 这 样 设计 的 ， 它 们 之 间 的 最 大 差别 仅仅 在 于 以 下 两 点 。 


1) 对 控件 的 控制 程度 : 能 够 捕获 到 尽 可 能 多 的 控件 信息 ， 能 有 更 多 方式 对 控件 进行 操控 ， 这 直接 决定 一 款 自动 化 框架 的 战斗 力 。 





2) 与 控件 的 耦合 度 : 换 句 话说 ， 就 是 对 源码 的 依赖 程度 ， 对 源码 依赖 越 小 的 框架 ， 越 独立 ， 覆 盖 到 的 面 也 就 越 广 。 





$ 
开始 有 点 意思 了 ， 不 过 不 着 急 ， 咱 们 先 来 看 看 如 何 获取 控件 的 可 见 边 界 ! 








小 插曲 5: 获取 控件 的 可 见 边界 








获取 控件 的 可 见 边界 方法 getVisibleBounds()， 使 用 方法 如 下 。 

















Rect rect = getVisibleBounds (node); 





进入 该 方法 ， 如 代码 清单 11-15 所 示 。 





代码 清单 11-15 getVisibleBounds() 





private Rect getVisibleBounds (AccessibilityNodeInfo node) ( 
if (node — null) ( 
return null; 


l 
// xuben: 首先 通过 AccessibilityNodeInfoHelper 的 
// getVisibleBoundsInScreen () 获取 该 节点 在 当前 屏幕 的 可 见 范围 内 的 边界 
Rect nodeRect = AccessibilityNodeInfoHelper.getVisibleBoundsInScreen (node); 
// xuben: 若 该 节点 的 父 节点 具有 党 动 属性 ( 即 当前 屏幕 可 能 无 法 完全 显示 
// 该 父 节点 的 所 有 子 节点 时 ， 该 节点 可 能 无 法 找到 ) 
AccessibilityNodeInfo scrollableParentNode = getScrollableParent (node); 
// xuben: 若 该 节点 的 父 节点 无 滚动 属性 ， 则 直接 返回 该 节点 边界 
if(scrollableParentNode == null) { 
return nodeRect; 


l 

// xuben: 若 该 节点 的 父 节 点 具有 滚动 属性 ， 则 获取 其 父 节 点 的 边界 

Rect parentRect = AccessibilityNodeInfoHelper 
-getVisibleBoundsInScreen (scrollableParentNode) ; 

// xuben: 依照 其 父 节点 边界 调整 目标 节点 边界 

nodeRect.intersect (parentRect); 

return nodeRect; 





具体 步骤 如 下 。 





A 


边界 获取 : 首先 通过 AccessibilityNodelnfoHelper 的 getVisibleBoundsinscreen() 方 法 获取 该 节点 在 当前 屏幕 的 可 见 范围 内 的 边界 。 











2) 是 否 为 滚动 界面 : 滚动 界面 可 能 无 法 完全 显示 该 父 节 点 的 所 有 子 节点 时 ， 导 致 目标 节点 可 能 无 法 找到 。 
“ 若 该 节点 的 父 节点 无 滚动 属性 ， 则 直接 返回 该 节点 边界 ; 


“ 车 该 节点 的 父 节点 具有 滚动 属性 ， 则 获取 其 父 节点 的 边界 。 





3) 边界 调整 : 依照 其 父 节点 边界 调整 目标 节点 边界 。 


$9, ran 逻辑 很 清楚 : 如 果 该 节点 的 父 节点 没有 滚动 属性 ， 那 在 当前 界面 就 能 获取 整个 控件 树 ， 该 节点 控件 的 边界 获取 也 没 问题 。 若 其 父 节点 存在 滚动 属性 ， 那 就 需要 调整 节点 边界 以 便 获 取 
该 控件 的 边界 。 


小 插曲 6: 获取 当前 界面 控件 边界 


这 里 ， 通 过 AccessibilityNodelnfoHelper 的 getVisibleBoundsinscreen() 方 法 获取 当前 界面 控件 边界 ， 继 续 进 入 查看 ， 如 代码 清单 11-16 所 示 。 


代码 清单 11-16 getVisibleBoundsinscreen() 


static Rect getVisibleBoundsInScreen (AccessibilityNodeInfo node) { 
if (node == null) { 
return null; 


l 
// xuben: i&itgetBoundsInScreen() 获取 节点 边界 ， 这 里 调用 了 
// AMccessibilityNodeInfo 的 getBoundsInScreen () 方法 ， 
// 通过 Rect 对 象 mBoundsInScreen 返 回 该 节点 的 上 、 下 、 左 、 右 四 个 边界 
Rect nodeRect = new Rect(); 
node.getBoundsInScreen (nodeRect) ; 
// xuben: i&itDisplayManagerGlobal$jgetRealDisplay () 方法 获取 逻辑 显示 信息 
Rect displayRect = new Rect(); 
Display display = DisplayManagerGlobal.getInstance () 
.getRealDisplay (Display.DEFAULT DISPLAY); 
Point outSize - new Point(); T 
// xuben: 获取 显示 坐标 (x,y) ， 即 此 处 的 outSize.x 及 outSize.y 
display.getSize (outSize); 
displayRect.top = 0; 
displayRect.left - 0; 
displayRect.right = outSize.x; 
displayRect.bottom = outSize.y; 
// xuben: 根据 坐标 进行 设置 
nodeRect.intersect (displayRect); 
return nodeRect; 








具体 步骤 如 下 。 























1) 边界 获取 : 通过 getBoundsinscreen() 方 法 获取 节点 边界 ， 这 里 调用 了 Accessibility-Nodelnfo 的 getBoundsinscreen() 方 法 ， 通 过 Rect 对 象 mBoundsinscreen 返 回 该 节点 的 上 、 下 、 左 、 右 四 个 边 


2) 获取 逻辑 显示 信息 : 通过 DisplayManagerGlobal 的 getRealDisplay( 方 法 获取 逻辑 显示 信息 。 
3) 获取 显示 坐标 : 获取 显示 坐标 (x,y)， 即 此 处 的 outSize.x 及 outSize.y。 


4) 动态 设置 : 根据 坐标 进行 设置 。 





获取 控件 的 可 见 边 界 算是 彻底 清晰 了 ， 也 知道 如 何 点 击 控件 ， 不 过 还 有 个 小 问题 ， 如 果 我 希望 滚动 到 某 个 对 象 ， 如 何 实现 呢 ? 
小 插曲 7: 滚动 到 某 个 元 素 对 象 
e.. : 
滚动 到 某 个 元 素 对 象 代码 如 下 。 


滚动 到 某 个 元 素 对 象 ， 如 代码 清单 11-17 所 示 。 


代码 清单 11-17 ”滚动 到 某 个 元 素 对 象 





public boolean scrollIntoView(UiSelector selector) throws UiObjectNotFoundException { 

Tracer.trace (selector); 

// xuben: 若 在 当前 页 面 找到 该 元 素 则 直接 返回 Lrue 

if (exists (getSelector().childSelector(selector))) { 
return (true); 

// xuben: 若 当前 页 面 不 存在 ， 则 继续 查找 

} else ( 
// xuben: i&itscrollToBeginning () 方法 滚动 到 起 始 位 置 
scrollToBeginning (mMaxSearchSwipes) ; 
// xuben: 若 在 起 始 位 置 找 到 该 元 素 则 直接 返回 Lrue 
if (exists (getSelector () .childSelector (selector))) { 

return (true); 


l 
// xuben: 若 起 始 位 置 仍 没 找到 则 循环 滚动 寻找 
for (int x = 0; x < mMaxSearchSwipes; xt+) ( 
// xuben: 若 无 法 继续 滚动 则 返回 false 
if(!scrollForward()) ( 
return false; 
l 
// xuben: 若 在 滚动 中 找到 该 元 素 则 返回 Lrue 
if (exists (getSelector().childSelector (selector))) { 
return true; 
} 
} 


} 
// xuben: 若 循 环 滚动 结束 仍 未 找到 该 元 素 则 返回 false 


return false; 





具体 步骤 如 下 。 











1) 若 在 当前 页 面 找到 该 元 素 则 直接 返回 true。 
2) 若 当前 页 面 不 存在 ， 则 继续 查找 。 


3) 通过 scrollToBeginning() 方 法 滚动 到 起 始 位 置 。 

















4) 若 在 起 始 位 置 找到 该 元 素 则 直接 返回 true。 





5) 若 起 始 位 置 仍 没 找到 则 循环 滚动 寻找 。 
“ 车 无 法 继续 滚动 则 返回 false。 


“ 车 在 滚动 中 找到 该 元 素 则 返回 true。 








6) 若 循环 滚动 结束 仍 未 找到 该 元 素 则 返回 false。 





E] 
全 还 辑 很 清晰 ， 连 我 都 能 看 懂 ， 大 家 就 更 没有 问题 了 ! 再 来 看 看 屏幕 截图 。 











11.2.6 ”获取 屏幕 截图 


获取 屏幕 截图 方法 如 下 。 








UiDevice.getInstance () .takeScreenshot (displayPicFile) ; 





之 前 我 们 也 提示 过 ， 传 入 的 参数 并 不 是 文件 路 径 ， 而 是 包含 文件 绝对 路 径 的 file 格 式 的 文件 。 进 入 UiDevicejava 查 看 ， 如 代码 清单 11-18 所 示 。 





代码 清单 11-18 UiDevice.java:takeScreenshot() 





public boolean takeScreenshot (File storePath) { 
Tracer.trace (storePath); 
return takeScreenshot (storePath, 1.0f, 90); 
} 
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这 里 传 入 的 参数 除了 截图 文件 外 ， 还 包括 截图 大 小 (这 里 1.0{ 为 截 


网 
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片 压缩 compression) ， 继 续 跟 进 ， 如 代码 清单 11-19 所 示 。 


代码 清单 11-19 takeScreenshot() 





public boolean takeScreenshot(File storePath, float scale, int quality) ( 
Tracer.trace(storePath, scale, quality); 
// xuben: ifitcom.android.systemui.screenshot .GlobalScreenshot #4 
// takeScreenshot () 方法 进行 截屏 
DisplayMetrics displayMetrics - new DisplayMetrics(); 
Display display = getDefaultDisplay(); 
display.getRealMetrics (displayMetrics); 
float[] dims = (displayMetrics.widthPixels, displayMetrics.heightPixels]; 
float degrees = getDegreesForRotation (display.getRotation()); 
boolean requiresRotation = (degrees > 0); 
Matrix matrix = new Matrix(); 
matrix.reset(); 
// xuben: 通过 setScale () E EAA Kh 
if (scale != 1.0f) ( 
matrix.setScale(scale, scale); 


l 
// xuben: 获取 当前 屏幕 方向 
if (requiresRotation) { 
matrix.preRotate (-degrees); 
} 
matrix.mapPoints (dims); 
dims[0] = Math.abs (dims[0]); 
dims[1] = Math.abs (dims[1]); 
// xuben: 通过 Surface 的 screenshot () 进行 截屏 ， 
// 这 个 方法 目前 存在 一 个 bug: 需要 当前 屏幕 方向 保持 原始 方向 才能 截屏 成 功 
Bitmap screenShot = Surface.screenshot((int) dims[0], (int) dims[1]); 
if (screenShot -- null) ( 
return false; 


} 
// xuben: 将 截图 旋转 为 当前 方位 
if (requiresRotation) { 
int width = displayMetrics.widthPixels; 
int height = displayMetrics.heightPixels; 
if (scale != 1.0f) ( 
width = Math.round(scale * width); 
height = Math.round(scale * height); 
} 
Bitmap ss = Bitmap.createBitmap (width, height, Bitmap.Config.ARGB 8888); 
Canvas c = new Canvas (ss); 
c.translate(ss.getWidth() / 2, ss.getHeight() / 2); 
c.rotate (degrees) ; 
c.translate(-dims[0] / 2, -dims[1] / 2); 
c.drawBitmap(screenShot, 0, 0, null); 
c.setBitmap (null); 
ScreenShot = ss; 


l 
// xuben: i&itsetHasAlpha () 对 截图 进行 优化 
screenShot.setHasAlpha (false); 
try { 
// xuben: 将 截图 保存 为 文件 ， 这 里 用 的 是 最 常用 的 FileOutputStream 
FileOutputStream fos = new FileOutputStream(storePath) ; 
// xuben: 对 图 像 进行 压缩 
ScreenShot.compress (Bitmap.CompressFormat.PNG, quality, fos); 
fos.flush(); 
fos.close(); 
) catch (IOException ioe) ( 
Log.e(LOG TAG, "failed to save screen shot to file", ioe); 
return false; 
) finally ( 
screenShot.recycle(); 
} 
return true; 


} 











具体 步骤 如 下 。 
1) 设置 大 小 : 通过 setscale() 方 法 设置 截图 大 小 。 














2) 获取 当前 屏幕 方向 : 通过 preRotate() 方 法 获取 当前 屏幕 方向 。 














3) 截屏 : 通过 Surface 的 screenshot() 方 法 进行 截屏 ， 这 个 方法 目前 存在 一 个 bug: 需要 当前 屏幕 方向 保持 原始 方向 才能 截屏 成 功 。 









































4) 旋转 截图 : 将 截图 旋转 为 当前 方位 。 
5) 优化 截图 : 通过 setHasAlpha() 方 法 对 截图 进行 优化 。 

















6) 将 截图 存 为 文件 : 将 截 | 


网 

















保存 为 文件 ， 这 里 用 的 是 最 常用 的 fileOutputStream。 

















7) 图 像 压缩 : 通过 compress() 方 法 对 图 像 进行 压缩 。 











这 个 方法 非常 清晰 : 截屏 、 旋 转 、 优 化 、 压 缩 、 保 存 。 


eo... 在 这 里 巴 哥 奔 提示 大 家 ， 可 以 回头 看 看 monkeyrunner 的 截屏 方法 ， 或 许 会 对 Android 的 截屏 有 一 个 更 加 清晰 的 认识 。 


11.2.7 ”发 送 返回 事件 


最 后 来 看 看 发 送 返 回 事件 ， 方 法 如 下 。 





UiDevice.getInstance().pressBack(); 





进入 UiDevice 查 看 ， 如 代码 清单 11-20 所 示 。 


代码 清单 11-20 UiDevice 





public boolean pressBack() { 

Tracer.trace(); 

waitForldle(); 

// xuben: 通过 UiAutomatorBridge 对 象 获得 之 前 初始 化 的 InteractionController 

// 对 象 并 调用 InteractionController 对 象 的 sendKeyAndWaitForEvent () 方法 

return mUiAutomationBridge.getInteractionController () .sendKeyAndWaitForEvent ( 
KeyEvent.KEYCODE BACK, 0, 
AccessibilityEvent.TYPE WINDOW CONTENT CHANGED, 


KEY PRESS EVENT TIMEOUT); 





=> un 猜测 的 一 样 ， 是 通过 sendKey 实 现 的 ， 只 不 过 这 里 是 通过 UiAutomator-Bridge 的 getinteractionController(0 方法 进行 控制 的 。 








这 里 传 入 的 参数 也 比较 复杂 : keycode 为 要 注入 的 按键 事件 ， 如 KEYCODE_BACK， 而 eventType 为 注入 事件 后 窗 








返回 的 AccessibilityEvent 类 型 ， 如 TYPE_Window_CONTENT_CHANGE。 





小 插曲 8: 事件 发 送 


进入 到 UiAutomatorBridge 查 看 getinteractionController() 方 法 ， 返 回 的 是 interactionController 对 象 。 





InteractionController getInteractionController() { 
return mInteractionController; 


} 





直接 进入 interactionController.java 查 看 sendKeyAndWaitForEvent0 方 法 ， 如 代码 清单 11-21 所 示 。 





代码 清单 11-21 sendKeyAndWaitForEvent() 





public boolean sendKeyAndWaitForEvent (final int keyCode, final int metaState, 
final int eventType, long timeout) ( 
mUiAutomatorBridge.setOperationTime(); 
Runnable command = new Runnable() { 
@Override 
public void run() { 
final long eventTime = SystemClock.uptimeMillis (); 
KeyEvent downEvent = KeyEvent.obtain(eventTime, eventTime, 
KeyEvent.ACTION DOWN, 
keyCode, 0, metaState, KeyCharacterMap.VIRTUAL KEYBOARD, Di 05. 
InputDevice.SOURCE KEYBOARD, null); 
// xuben: i&itinjectEventSync () 进行 事件 发 送 
if (injectEventSync (downEvent)) ( 
KeyEvent upEvent = KeyEvent.obtain(eventTime, eventTime, 
KeyEvent.ACTION UP, 
keyCode, 0, metaState, KeyCharacterMap.VIRTUAL KEYBOARD, 0, 0, 
InputDevice.SOURCE KEYBOARD, null); 
injectEventSync (upEvent) ; 
} 
} 
i 
// xuben: i&itrunAndWaitForEvent () 方法 执行 注入 事件 线程 


return runAndWaitForEvent (command, timeout, eventType) != null; 





这 里 通过 创建 Runnable 线 程 进行 事件 注入 ， 注 入 后 还 需 等 待 预 期 的 eventType 是 否 出 现 来 判断 事件 注入 是 否 成 功 。 











这 里 通过 injectEventSync() 方 法 进行 事件 发 送 ， 所 以 继续 跟 进 ， 如 代码 清单 11-22 所 示 。 


代码 清单 11-22 事件 发 送 





private static boolean injectEventSync(InputEvent event) { 
return InputManager.getInstance ().injectInputEvent (event, 
InputManager.INJECT INPUT EVENT MODE WAIT FOR FINISH); 














这 里 调 





了 InputManager 的 injectlnputEvent() 方 法 ， 如 代码 清单 11-23 所 示 。 


代码 清单 11-23  injectInputEvent() 





public boolean injectInputEvent (InputEvent event, int mode) ( 
if (event = null) { 
throw new IllegalArgumentException ("event must not be null"); 
} 


if (mode != INJECT INPUT EVENT MODE ASYNC 
&& mode !- INJECT INPUT EVENT MODE WAIT FOR FINISH 
&& mode !- INJECT INPUT EVENT MODE WAIT FOR RESULT) { 


throw new 
} 
try { 

// xuben: 调用 injectInputEvent () 进行 事件 发 送 

return mIm.injectInputEvent (event, mode); 
} catch (RemoteException ex) { 

return false; 


} 


IllegalArgumentException("mode is invalid"); 




















很 清晰 ， 通 过 层 层 调 





， 最 终 通 过 Android 的 Input 进 行事 件 发 送 。 


11.3 ”UIAutomator 的 原理 总 结 


OO ps T, AERA? 





学 到 相当 多 ! 

eo R? 说 来 听 听 。 

全 如 果 说 Instrumentation 让 我 们 更 了 解 Android 系 统 运行 和 窗口 管理 机 制 的 话 ， 那 么 UIAutomator 则 让 我 们 从 全 新 的 角度 去 审视 一 款 独立 、 成 熟 的 自动 化 框架 设计 。 
e... 说 得 没 错 ! 


E] 
人 这 一 趟 旅程 下 来 ， 从 控件 捕获 到 创建 UiObject 对 象 到 验证 控件 的 存在 性 和 可 用 性 ， 再 到 点 击 并 等 待 界 面 跳 转 ， 到 获取 屏幕 截图 ， 最 后 到 发 送 事件 。 感 觉 将 测试 框架 整个 事 了 一 遍 。 


go 具体 说 说 。 


全 例如， 了 解 了 控件 捕获 和 操作 的 基本 原理 ， 我 就 知道 如 何 通过 UiAutomator-Bridege 获 取 界 面 或 进行 事件 注入 。 






fe 
人 再 如 ， 学 习 了 如 何 获取 控件 根 节点 ， 如 何 遍 历 整 棵 控件 树 ， 让 我 对 整个 控件 树 的 定位 和 遍历 的 还 辑 更 加 清晰 。 
当 我 学 习 了 如 何 获 取 控件 边界 ， 如 何 滚动 到 某 个 元 素 ， 我 更 深入 地 了 解 了 对 控件 进行 操作 时 必须 明确 的 东西 。 


E] 
全 % 最后， 学 习 了 如 何 进行 事件 发 送 ， 这 也 让 我 再 次 加 深 了 对 通过 Android 的 Input 进 行事 件 发 送 的 印象。 


99. 理解 得 很 到 位 ， 可 以 进入 下 一 轮 了 ! 


第 12 章 “CTS 原理 分 析 





分 析 CTS 源 码 ， 那 简直 是 一 种 享受 ! 


121 “CTS 源 码 结构 





CTS 源 码 位 于 “~\cts\tools\tradefed-host\src\com\android\cts\tradefed\” 目录 中 ， 对 应 源码 树 如 图 12-1 所 示 。 














LC] 
全 KOK， 咱 们 抓紧 开始 吧 ! 


122 CTS 架 构 分 析 





CTS 源 码 分 析 两 条 线路 ， 如 下 。 





1) 路 线 1: 和 之 前 一 样 ， 根 据 CTS 命 令 源 码 分 析 其 大 框架 。 





























2) 路 线 2: 从 某 个 应 用 (如 MediaPlayer) 的 CTS 测 试 ， 分 析 其 具体 测试 内 容 。 














从 好 像 都 很 不 错 哦 ， 咱 们 怎么 选 ? 


Bo, orans 原因 如 下 。 


经 过 仔细 思考 ， 巴 哥 奔 决定 选择 路 线 2， 原 因 如 下 。 























1) 绝 大 多 数 CTS 的 测试 用 例 均 来 自 Android 官 方 测试 用 例 ， 非 常 有 学 习 价值 。 





















































2) 未 来 咱们 将 学 习 如 何 利用 CTS 框 架 添加 单元 测试 用 例 ， 所 以 提前 学 习 CTS 官 方 用 例 对 以 后 添加 大 有 神 益 。 

















基于 此 ， 巴 哥 奔 挑选 了 MediaPlayerTest 作 为 学 习 模 板 ， 供 大 家 一 起 学 习 。 


源码 地 址 : “~\cts\tests\tests\media\src\android\media\cts\MediaPlayerTestjava” 。 








MediaPlayerTest 继 承 自 MediaPlayerTestBase， 而 MediaPlayerTestBase 则 继承 自 ActivitylnstrumentationTestCase2<MediastubActivity> 。 我 们 知道 ， 如 果 希 望 测试 Activity 与 Android 的 交互 一 
般 都 会 选择 继承 ActivitylnstrumentationTestCase2。 更 重要 的 是 ，Instrumentation 也 继承 自 ActivitylnstrumentationTestCase2<T extends Activity> ， 由 此 可 看 出 CTS 与 Instrumentation 的 渊源 。 






































不 过 ， 在 Android 4.2 后 ，CTS 增 加 了 一 个 CtsUIAutomatorTest，CtsUIAutomatorTest 继 承 自 UIAutomatorTestCase， 而 UIAutomatorTestCase 源 于 Android 主 推 的 自动 化 测试 框架 UIAutomator， 
由 此 可 见 ，Android 对 新 一 代 自 动 化 测试 框架 的 重视 。 
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图 12-1 CTS 源码 树 


2 CTS 案 例 MediaPlayer 分 析 


要 测试 MediaPlayer 的 接口 ， 就 需要 先 了 解 MediaPlayer 类 都 提供 了 哪些 基本 接口 以 供 测试 。 


MediaPlayer 在 Android 官 网 地 址 : http://developer.android.com/reference/android/media/Media-Player.htm 





下 面 有 一 张 非常 详尽 的 状态 切换 图 ， 如 图 12-2 所 示 。 
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从 这 张 图 不 难 发 现 MediaPlayer 在 音乐 、 视 频 播放 过 程 中 的 种 种 状态 切换 ， 以 及 这 些 状态 切换 所 需 调 用 的 各 个 接口 。 





关于 MediaPlayer 的 状态 切换 ， 有 很 多 文章 都 进行 归 类 和 分 析 ， 如 http://blog.csdn.net/dabenben_ben/article/details/6232941， 这 里 ， 巴 哥 奔 对 其 简单 归 类 ， 如 图 12-3 所 示 。 










— 获取 视频 的 尺寸 
— SEX | 
”获取 音 /视频 的 时 长 “~ 


图 12-3 ”MediaPlayer 状 态 切 换 归 类 


从 图 中 不 难看 出 有 如 下 状态 。 











1) 创建 : 通过 new() 方 法 创建 MediaPlayer 对 象 ， 其 状态 为 Idle， 在 运行 过 程 中 若 调用 reset() 方 法 则 其 状态 将 再 次 回 到 ldle。 














2) 初始 化 : 通过 setDataSource() 方 法 对 MediaPlayer 进 行 初始 化 ， 该 方法 设置 播放 文件 。 
3) 准备 : 通过 prepare() 或 者 prepareAsync() 方 法 将 使 MediaPlayer 对 象 进入 到 prepared 状 态 。 
4) 播放 : 通过 start( 方 法 开始 播放 ， 通 过 isPlayfing() 方 法 来 查询 播放 器 状态 。 


5) 暂停 : 通过 pause() 方 法 进行 暂停 ， 通 过 start() 方 法 可 恢复 播放 。 





6) 停止 : 通过 stop( 方 法 进行 停止 ， 无 法 恢复 播放 ， 只 能 通过 prepare() 方 法 或 者 prepareAsyn() 方 法 才能 使 其 再 次 进入 prepared 状 态 。 























7) 快 进 / 快 退 : 通过 seekTo() 方 法 可 调整 MediaPlayer 的 媒体 时 间 以 实现 快 退 和 快 进 的 功能 ，seekTo() 方 法 在 started、paused、prepared 和 playbackCompleted 状 态 下 均 可 异步 调用 。 
8) 获取 音 / 视 频 的 时 长 : 通过 getDuration() 方 法 进行 获取 。 


9) 获取 视频 的 尺寸 : 通过 getVideoWidth() 方 法 和 getVideoHeight() 方 法 进行 获取 。 








10) 错误 处 理 : 当 错 误 发 生 时 ，onErrorListener.onError() 方 法 会 被 调用 (需要 先 为 MediaPlayer 对 象 注册 onErrorListener 监 听 器 ) ，MediaPlayer 对 象 进入 到 error 状 态 。 














11) 销毁 : 通过 release() 方 法 使 其 进入 到 end 状 态 ， 释 放 资 源 。 


了 解 以 上 基本 信息 后 ， 我 们 可 以 看 看 该 如 何 对 MediaPlayer 进 行 测试 。 


eo 巴 哥 奔 自 从 事 Android 测 试 以 来 ， 做 过 Android 自 动 化 测试 、 压 力 测试 和 单元 测试 ， 也 曾 开发 过 一 些 核心 模块 常用 接口 测试 的 工具 ， 包 括 对 MediaPlayet 的 单元 测试 设计 ， 当 时 自 认为 测试 得 很 详尽 ， 
很 透彻 。 


SSA, HR, ek aT Re 


? M 当 巴 哥 奔 打开 CTS 针 对 Media 的 测试 文件 后 ， 还 是 被 深 深 地 震撼 了 1! 
针对 Media 的 接口 测试 居然 设计 出 如 此 多 的 场景 和 测试 角度 ， 这 不 仅 需要 对 接口 的 深入 理解 、 对 应 用 的 了 如 指 掌 、 对 测试 设计 的 熟练 掌握 ， 更 需要 多 年 的 积累 和 浸润 。 


谷歌 单元 测试 工程 师 们 把 接口 测试 这 块 做 到 了 极致 。 与 其 说 是 一 种 功力 ， 不 如 说 是 一 种 态度 ! 
LU . 
-哈哈 ， 那 咱们 就 通过 分 析 MediaPlayetTest 对 其 进行 管 中 帘 豹 吧 ! 


12.2.2 ”测试 资源 预 置 及 环境 清理 





由 于 CTS 是 接口 兼容 性 测试 ， 所 以 CTS 的 主体 框架 还 是 遵循 JUnit 那 一 套 。 既 然 遵 循 JUnit， 那 就 让 我 们 先 来 看 看 MediaPlayerTest 的 setup0 和 tearDown() 两 个 方法 ( 即 开始 测试 前 的 资源 预 置 和 测试 完 











成 后 的 环境 清理 ) ， 如 代码 清单 12-1 和 代码 清单 12-2 所 示 。 


代码 清单 12-1 MediaPlayerTest:setup() 





GOverride 
protected void setUp() throws Exception { 
// xuben: 调用 父 类 ， 即 MediaPlayerTestBase 的 setup () 
super.setUp(); 
// xuben: 从 预定 路 径 获取 播放 文件 
RECORDED FILE = new File (Environment.getExternalStorageDirectory()， 
"mediaplayer record.out") -getAbsolutePath(); 
mOutFile — new File(RECORDED FILE); 





代码 清单 12-2  MediaPlayerTest::tearDown() 





GOverride 
protected void tearDown() throws Exception ( 
// xuben: 调用 父 类 ， 即 MediaPlayerTestBase 的 tearDown () 
super.tearDown(); 
// xuben: 车 播放 文件 不 为 空 且 还 存在 ， 删 除 播放 文件 
if(mOutFile != null && mOutFile.exists()) { 
mOutFile.delete(); 
} 
} 





全 既然 是 调用 父 类 的 setup0 和 tearDown0 方 法 ， 那 就 让 咱们 到 父 类 中 一 探 完 竟 吧 ! 
父 类 MediaPlayerTestBase 中 的 setUp0 和 tearDown() 方 法 ， 如 代码 清单 12-3 和 代码 清单 12-4 所 示 。 


代码 清单 12-3 MediaPlayerTestBase::setup() 





GOverride 
protected void setUp() throws Exception { 
// xuben: 调用 父 类 ， 即 ActivityInstrumentationTestCase2 的 setup () 
super.setUp(); 
// xuben: 获取 Activity 
mActivity = getActivity(); 
// xuben: 通过 Instrumentation 异 步 等 待 应 用 程序 进入 idle 状 态 
getInstrumentation () .waitForIdleSync (); 
try { 
runTestOnUiThread (new Runnable() { 
public void run() { 
// xuben: 创建 两 个 MediaPlayer 对 象 : mMediaPlayerjfemMediaPlayer2, 
// 请 读者 记 住 这 两 个 对 象 ， 未 来 经 常 被 调用 
mMediaPlayer = new MediaPlayer(); 
mMediaPlayer2 = new MediaPlayer(); 
} 
n; 
) catch(Throwable e) ( 
e.printStackTrace(); 
fail(); 


l 

// xuben: 通过 Instrumentation 获 取 资 源 文件 

mContext = getInstrumentation () .getTargetContext (); 
mResources = mContext.getResources(); 





代码 清单 12-4 MediaPlayerTestBase::tearDown() 





GOverride 
protected void tearDown() throws Exception ( 
// xuben: 若 mMediaPlayer 和 mMediaPlayer2 对 象 不 为 空 则 通过 release () 释放 这 两 
// 个 对 象 的 资源 并 销毁 对 象 ， 这 里 我 们 看 到 MediaPlayer 的 release () 接 口 被 调用 
if(mMediaPlayer != null) ( 
mMediaPlayer.release(); 
mMediaPlayer = null; 


} 

if(mMediaPlayer2 != null) ( 
mMediaPlayer2.release(); 
mMediaPlayer2 = null; 


l 

// xuben: 44%Activity# ARK, 

// 即 ActivityInstrumentationTestCase2 的 tearDown () 
mActivity = null; 

super.tearDown(); 





测试 资源 预 置 及 环境 清理 总 结 ， 如 图 12-4 所 示 。 





创建 两 个 MediaPlayer 对 象 : 
mMediaPlayer 和 mMediaPlayer2 


一 setup() 引 父 类 MediaplayerTestBase > 通过 Instrumentation 获 取 资 源 文件 
从 预定 路 径 获 取 播 放 文件 








通过 release() 释 放 这 两 个 对 象 的 资源 并 销毁 对 象 
| tearDown() =; 3t2MediaPlayerTestBase ;销毁 Activity 并 调用 父 类 
lemmixHxsOmust.NAMEESM — 


12-4 测试 资源 预 置 及 环境 清理 




















1223 ” 空 文件 及 音 视频 播放 测试 


< 人 <% 看 完了 接口 测试 必 备 的 setup0 和 teatDown0 方 法 后 ， 接 下 来 咱们 就 按 顺序 看 看 MediaPlayerTest 都 设计 了 哪些 测试 场景 吧 ! 








首先 进入 眼帘 的 是 非常 常见 的 3 个 测试 场景 : 空 文件 播放 测试 、 音 乐 播放 测试 和 视频 播放 测试 ， 先 来 看 看 空 文件 播放 测试 ， 如 代码 清单 12-5 所 示 。 














代码 清单 12-5 “” 空 文件 播放 测试 





public void testPlayNullSource() throws Exception { 
try { 
// xuben: ilii MediaPlayeréjsetDataSource () 方法 将 文件 设置 为 nul1 
mMediaPlayer.setDataSource((String) null); 
fail("Null URI was accepted"); 
} catch(RuntimeException e) { 
// expected 











将 
F 
i 
> 





测试 用 例 只 是 测试 播放 器 的 空 文件 设置 ， 并 没有 测试 空 文件 播放 。 





接 下 来 ， 我 们 再 看 看 音频 播放 测试 ， 如 代码 清单 12-6 所 示 。 


代码 清单 12-6 ”音乐 播放 测试 





public void testPlayAudio() throws Exception ( 
final int mp3Duration = 34909; 
final int tolerance - 70; 
final int seekDuration - 100; 
final int resid - R.raw.testmp3 2; 
// xuben: 重新 创建 MediaPlayer 对 象 mp， 并 通过 create () 方法 
// 使 mp 对 象 直接 处 于 Prepared 状 态 ， 相 当 于 系统 根据 参数 的 
// 资源 ID 调用 了 setDataSource () 和 prepare () 方法 
MediaPlayer mp = MediaPlayer.create (mContext, resid); 
try { 
// xuben: i&itsetAudioStreamType () 方法 设置 音频 流 
mp.setAudioStreamType (AudioManager.STREAM MUSIC); 
// xuben: 通过 setWakeMode () 方法 确保 当 MediaPlayer 正 在 播放 
// 时 CPU 继 行 ， 设 置 完成 后 ，MediaPlayer 在 播放 的 时 候 桂 
// 有 指定 的 锁 并 且 在 暂停 或 停止 时 释放 锁 
mp.setWakeMode (mContext, PowerManager.PARTIAL WAKE LOCK) ; 
// xuben: 验证 当前 播放 器 不 在 播放 状态 
assertFalse (mp.isPlaying()); 
// xuben: 开始 播放 
mp.start(); 
// xuben: 验证 当前 播放 器 已 进入 播放 状态 
assertTrue (mp.isPlaying()); 
// xuben: 验证 当前 播放 器 不 在 循环 状态 
assertFalse (mp.isLooping()); 
// xuben: 开启 当前 播放 器 循环 模式 
mp.setLooping (true); 
// xuben: 验证 当前 播放 器 已 进入 循环 状态 
assertTrue (mp.isLooping()); 
// xuben: 通过 getDuration () 获 取 当 前 音频 文件 的 播放 长 度 (Duration), 
// 并 验证 其 等 于 预定 长 度 mp3Duration ( 即 34909) ， 注 意 这 里 的 第 三 
// 个 参数 为 允许 误差 范围 ， 此 处 为 70 
assertEquals (mp3Duration, mp.getDuration(), tolerance); 
// xuben: 通过 getCurrentPosition () 获取 其 播放 位 置 ， 并 验证 该 位 置 大 于 
// 0 且 小 于 总 播放 时 长 减 去 预计 跳 转 时 长 ， 这 是 为 下 一 步 的 快 进 做 准备 
int pos = mp.getCurrentPosition(); 
assertTrue (pos >= 0); 
assertTrue (pos < mp3Duration - seekDuration); 
// xuben: 通过 seekTo () 方法 快 进 播放 器 ， 此 处 快 进 seekDuration 
// 为 100 milliseconds， 接 着 验证 其 快 进位 置 与 通过 getCurrentPosition () 
// 获取 的 当前 位 置 相等 
mp.seekTo(pos + seekDuration); 
assertEquals (pos * seekDuration, mp.getCurrentPosition(), tolerance); 
// xuben: 通过 pause () 使 播放 器 暂停 ， 并 通过 isPlaying () 验证 其 此 时 
// 不 处 于 播放 状态 
mp.pause () ; 
Thread. sleep (SLEEP_TIME) ; 
assertFalse (mp.isPlaying()); 
// xuben: 通过 start () 使 播放 器 恢复 播放 ， 再 次 通过 isPlaying () 验证 
// 其 此 时 恢复 播放 状态 
mp.start(); 
assertTrue (mp.isPlaying()); 
// xuben: 通过 stop () 停 止 播放 器 
mp.stop(); 
// xuben: 正如 我 们 之 前 的 分 析 ， 当 播放 器 停止 后 ， 就 不 能 直接 通过 
// start () 使 播放 器 恢复 播放 ， 需 要 进行 一 系列 复杂 的 操作 ， 如 reset ()、 
// setDataSource(). prepare () 等 
mp.reset(); 
AssetFileDescriptor afd = mResources.openRawResourceFd (resid) ; 
mp.setDataSource (afd.getFileDescriptor(), afd.getStartOfset(), afd.getLength()); 
afd.close(); 
mp.prepare () ; 
// xuben: 调用 prepare () 方法 后 ， 此 时 播放 器 应 该 仍 处 于 未 播放 状态 
assertFalse (mp.isPlaying()); 
// xuben: 经 过 一 系列 操作 ， 再 次 调用 start () 方法 ， 播 放 器 恢复 播放 
mp.start(); 
assertTrue (mp.isPlaying()); 
// xuben: 循环 等 待 播放 结 
while (mp.isPlaying()) { 
Thread.sleep(SLEEP TIME); 
$ 
finally { 
// xuben: 如 果 测试 过 程 中 出 现任 何 意外 ， 
// 直接 调用 release () 释放 MediaPlayer 对 象 
mp.release(); 








$9, s 出 ， 播 放 音 频 文件 是 测试 MediaPlayer 的 重点 所 在 ， 所 以 设计 了 这 么 多 场景 进行 音频 播放 测试 。 
接 下 来 的 视频 播放 就 要 简单 很 多 了 ， 如 代码 清单 12-7 所 示 。 


代码 清单 12-7 ”视频 播放 测试 





public void testPlayVideo() throws Exception { 
// xuben: 调用 父 类 ， 即 MediaPlayerTestBase 的 playVideoTest () 测 试 方法 
playVideoTest(R.raw.testvideo, 352, 288); 











此 处 调用 了 父 类 的 testPlayVideo()， 我 们 一 起 来 看 看 ， 如 代码 清单 12-8 所 示 。 








代码 清单 12-8 ”设置 宽 、 高 的 视频 播放 测试 





protected void playVideoTest(int resid, int width, int height) throws Exception { 
// xuben: 通过 resid 获 取 视 频 文件 
loadResource (resid); 
// xuben: 通过 playLoadedVideo () 方法 播放 视频 文件 并 设置 播放 器 宽度 和 高 度 
playLoadedVideo (width, height, 0); 








-人 说白 了 就 是 播放 、 快 进 、 暂 





停 、 停 止 与 恢复 ， 哈 哈 ! 





空 文件 及 音 视频 播放 测试 ， 如 图 12-5 所 示 。 














虽然 测试 方法 看 似 简 单 ， 但 其 实 父 类 的 loadResource0 和 playLoadedVideo() 方 法 都 比较 复杂 ， 不 过 这 里 主要 关注 CTS 测 试用 例 以 及 测试 用 例 框架 ， 所 以 此 处 就 不 详 述 了 ， 感 兴趣 的 朋友 可 以 自行 研究 。 


一 。 空 文件 播放 测试 = 通过 setDataSource() 方 法 将 文件 设置 为 null 








一 音频 播放 测试 - 





验证 当前 播放 器 不 在 播放 状态 
播放 前 后 ” 验证 当前 播放 器 已 进入 播放 状态 
验证 当前 播放 器 不 在 循环 状态 
播放 器 循环 模式 前 后 = 验证 当前 播放 器 已 进入 循环 状态 


验证 音频 文件 的 播放 长 度 等 于 预定 长 度 
URIREH CRAS BENE. 
、 J TRV CFS 
播放 器 快 进 前 后 ”| 快 进 播 放 器 到 某 个 位 轩 
验证 其 快 进位 置 等 于 预期 
播放 器 暂停 播放 
验证 其 此 时 不 处 于 播放 状态 
播放 器 暂 停 与 恢复 -| 播放 器 恢复 播放 
验证 其 此 时 处 于 播放 状态 


播放 器 停止 播放 

验证 其 此 时 不 处 于 播放 状态 
播放 器 停止 与 恢复 = 播放 器 恢复 播放 

验证 其 此 时 处 于 播放 状态 























/普通 播放 测试 


N 视频 播放 测试 - 








12-5 








播放 视频 文件 并 设置 播放 器 宽度 和 高 度 


空 文件 及 音 视频 播放 测试 


1224 切换 下 一 首 歌 测试 


测试 过 简单 的 音 视频 播放 后 ， 接 下 来 需要 切换 下 一 首 歌 查 看 是 否 正常 ， 如 代码 清单 12-9 所 示 。 








代码 清单 12-9 ”切换 下 一 首 歌 测试 








public void testSetNextMediaPlayer() throws Exception { 
// xuben: 初始 化 播放 器 mMediaPlayer， 此 处 的 初始 化 ， 
// 除了 调用 基本 的 reset () ，setDataSource () prepare () 外 ， 
// 还 通过 seekTo (56000) 将 播放 文件 设置 于 56 秒 位 置 进行 播放 
initMediaPlayer (mMediaPlayer); 
final Monitor mTestCompleted - new Monitor(); 
Thread timer = new Thread(new Runnable() { 
GOverride 
public void run() ( 
long startTime = SystemClock.elapsedRealtime () ; 
while(true) { 
SystemClock.sleep (SLEEP TIME); 
if (mTestCompleted.isSignalled()) { 
// done 
return; 
} 
long now = SystemClock.elapsedRealtime () ; 
if((now - startTime) > 25000) { 
android.os.Process.sendSignal (android.os.Process.myPid(), 3); 
SystemClock.sleep (2000); 


fail("Test is stuck, see ANR stack trace for more info. You may need to" 


" create /data/anr first"); 
return; 


} 
} 


1; 
timer.start(); 
try 
for(int i = 0; i < 3; i++) f 

// xuben: 初始 化 播放 器 mMediaPlayer2， 

// 此 处 初始 化 与 初始 化 mMediaPlayer 一 臻 
initMediaPlayer (mMediaPlayer2); 
mOnCompletionCalled.reset(); 
mOnInfoCalled. reset (); 

// xuben: 为 播放 器 mMediaPlayer 设 置 播放 完成 监听 器 
mMediaPlayer.setOnCompletionListener (new 
MediaPlayer.OnCompletionListener() ( 
GOverride 
public void onCompletion (MediaPlayer mp) { 
assertEquals (mMediaPlayer, mp); 
mOnCompletionCalled.signal (); 


1); 
// xuben: 为 播放 器 mMediaPlayer2 设 置 播放 警告 或 错误 信息 监听 器 ， 如 ， 
// FER. SPIER. FAURE ECF 
mMediaPlayer2.setOnInfoListener (new MediaPlayer.OnInfoListener() { 
GOverride 
public boolean onInfo(MediaPlayer mp, int what, int extra) ( 
assertEquals (mMediaPlayer2, mp); 
if(what == MediaPlayer.MEDIA INFO STARTED AS NEXT) ( 
mOnInfoCalled.signal(); ^ ~ mo 
} 
return false; 
} 
1); 
// xuben: 正式 调用 setNextMediaPlayer () #mMediaPlayer2it 3t; 
// 当前 播放 器 mMediaPlayer 的 下 一 个 播放 器 
mMediaPlayer.setNextMediaPlayer (mMediaPlayer2); 
// xuben: 启动 播放 器 
mMediaPlayer.start(); 
// xuben: 进入 测试 ， 如 下 。 
// 1. 当 前 播放 器 mMediaPlayer 正 在 播放 测试 
// 2. monCompletionCalled 未 标记 测试 (mMediaPlayer 播 放 未 完成 ) 
// 3. 下 一 个 播放 器 mMediaPlayer2 未 播放 测试 
// 4. monInfoCalled 未 标记 测试 (mMediaPlayer2 未 收 到 播放 警告 或 错误 信 
assertTrue (mMediaPlayer.isPlaying()); 
assertFalse (mOnCompletionCalled.isSignalled()); 
assertFalse (mMediaPlayer2.isPlaying()); 
assertFalse (mOnInfoCalled.isSignalled()); 
// xuben: 循环 播放 至 当前 播放 器 mMediaP1ayer 播 放 完毕 
while (mMediaPlayer.isPlaying()) { 
Thread.sleep(SLEEP TIME); 
} 
Thread. sleep (100) ; 
// xuben: 理论 上 说 播放 器 已 切换 ， 进 入 测试 ， 如 下 。 
// 1.4% BmMediaPlayer2 正在 播放 测试 
// 2. moOnCompletionCalled 已 标记 测试 (mMediaPlayer 播 放 完 成 ) 
// 3. monInfoCalled 已 标记 测试 (mMediaPlayer2 收 到 播放 警告 或 错误 信息 ) 
assertTrue (mMediaPlayer2.isPlaying()); 
assertTrue (mOnCompletionCalled.isSignalled()); 
assertTrue (mOnInfoCalled.isSignalled()); 
// xuben: 此 时 播放 器 mMediaPlayer 已 播放 完毕 ， 而 播放 器 
// mMediaPlayer2 正 在 播放 ， 此 时 交换 这 两 个 播放 器 
MediaPlayer tmp = mMediaPlayer; 
mMediaPlayer = mMediaPlayer2; 
mMediaPlayer2 - tmp; 





} 
// xuben: 反复 循环 3 次 后 ， 此 时 播放 器 mMediaPlayer2 处 于 播放 完毕 状态 ， 
// 而 播放 器 mMediaPlayer 正 在 播放 ， 接 下 来 将 监听 器 重 置 ， 然 后 开始 测 null 项 ， 
// 即将 null 参 数 传 入 setNextMediaPlayer (null) 是 否 会 出 现 问题 
mOnCompletionCalled.reset(); 
mOnInfoCalled.reset(); 
initMediaPlayer (mMediaPlayer2); 
mMediaPlayer.setNextMediaPlayer (mMediaPlayer2); 
mMediaPlayer.setOnCompletionListener (new MediaPlayer.OnCompletionListener() { 
GOverride 
public void onCompletion (MediaPlayer mp) { 
assertEquals (mMediaPlayer, mp); 
mOnCompletionCalled.signal (); 
} 
n; 
mMediaPlayer2.setOnInfoListener (new MediaPlayer.OnInfoListener() { 
GOverride 
public boolean onInfo(MediaPlayer mp, int what, int extra) ( 
assertEquals (mMediaPlayer2, mp); 
if (what == MediaPlayer.MEDIA INFO STARTED AS NEXT) { 
mOnInfoCalled.signal (); 
} 
return false; 


} 


D; 

// xuben: 重 置 监听 器 后 测试 结果 应 与 第 一 次 检测 结果 一 臻 

assertTrue (mMediaPlayer.isPlaying()); 

assertFalse (mOnCompletionCalled.isSignalled()); 

assertFalse (mMediaPlayer2.isPlaying()); 

assertFalse (mOnInfoCalled.isSignalled()); 

Thread.sleep(SLEEP TIME); 

// xuben: 将 nul1 参 数 传 入 setNextMediaPlayer () , 

// 此 时 播放 器 mMediaP1layer 的 下 一 个 播放 器 为 空 

mMediaPlayer.setNextMediaPlayer (null); 

while (mMediaPlayer.isPlaying()) { 
Thread.sleep(SLEEP TIME); 

j 

Thread. sleep (100) ; 

// xuben: 进入 测试 ， 如下: 

// 1. 当 前 播放 器 mMediaPlayer 播 放 完毕 测试 

// 2. 下 一 个 播放 器 mMediaPlayer2 未 播放 测试 

// 3. monCompletionCalled 已 标记 测试 (mMediaPlayer 播 放 完 毕 ) 

// 4. moOnInfoCalled 未 标记 测试 (mMediaPlayer2 未 收 到 播放 警告 或 错误 信息 ) 

assertFalse (mMediaPlayer.isPlaying()); 

assertFalse (mMediaPlayer2.isPlaying()); 

assertTrue (mOnCompletionCalled.isSignalled()); 

assertFalse (mOnInfoCalled.isSignalled()); 

finally ( 

// xuben: 出 错 则 重 置 两 个 播放 器 

mMediaPlayer.reset(); 

mMediaPlayer2.reset(); 

} 

mTestCompleted. signal (); 





5 
全 % 奔 哥 曾 说 过 ， 看 上 去 很 繁杂 的 代码 ， 其 实 往往 很 简单 ， 关 键 是 要 理 出 条 理 来 ! 








切换 下 一 首 歌 测试 ， 如 图 12-6 所 示 。 























reset() , setDataSource() , prepare() 


。 初始 化 播放 器 ”号 将 播放 器 mMediaPlayer 播 放 文件 设置 于 56 秒 位 置 进行 播放 
初始 化 播放 器 mMediaPlayer2 


为 播放 器 mMediaPlayer 设 置 播放 完成 监听 器 
开始 缓冲 


j GEBETBg- 为 播放 器 mMediaPlayer2 设 置 缓冲 结束 
播放 警告 或 错误 信息 监听 器 下 载 速度 变化 等 


| / 将 mMediaPlayer2 设 置 为 当前 播放 器 mMediaPlayer 的 下 一 个 播放 器 
当前 播放 器 mMediaPlayer 正 在 播放 测试 
mMediaPlayer 播 放 未 完成 测试 
NM 下 一 个 播放 器 mMediaPlayer2 未 播放 测试 
mMediaPlayer2 未 收 到 播放 警告 或 错误 信息 测试 


播放 器 mMediaPlayer2 
正在 播放 测试 
。 播放 器 切换 后 “= mMediaPlayer 播 放 完 成 测试 
mMediaPlayer2 收 到 播放 警告 或 错误 信息 





| 。 交换 这 两 个 播放 器 ， 反 复 测试 3 次 


| 
。 重 置 监听 器 后 测试 结果 应 与 第 一 次 检测 结果 一 致 


| 当前 播放 器 mMediaPlayer 正 在 播放 测试 
个 播放 器 mMediaPlayer2 未 播放 测试 


下 一 41 
下 一 个 播放 器 置 空 测试 o mMediaPlayer 播 放 完 成 测试 
mMediaPlayer2 未 收 到 播放 警告 或 错误 信息 测试 


图 12-6 ”切换 下 一 首 歌 测试 


12.2.5 ”频谱 测试 


接 下 来 的 测试 都 有 点 奇 苑 ， 所 以 我 们 将 循环 多 次 测试 以 确保 结果 ， 如 代码 清单 12-10 所 示 


代码 清单 12-10 ”频谱 测试 





// xuben: 第 一 个 测试 将 传 入 两 个 文件 进行 播放 测试 : 
// 传 入 的 第 一 个 文件 为 无 声 并 伴随 强 正 直流 偏 移 的 mp3 文 件 
// 传 入 的 第 二 个 文件 为 无 声 并 伴随 强 负 直流 偏 移 的 mp3 文 件 
// 若 这 两 个 文件 出 现 播放 重 登 ， 播 放 将 取消 ， 并 探测 到 零 值 ， 
// 车 存在 播放 缺口 ， 也 将 探测 到 零 值 
// 注意 : 此 项 测试 并 不 保证 文件 被 正确 播放 
public void testGapless1() throws Exception { 
// xuben: 直接 调用 flakyTestWrappPer () 传 入 两 个 文件 ， 此 方法 下 面 将 详 述 
flakyTestWrapper (R.raw.monodcpos, R.raw.monodcneg); 
} 
/ xuben: 第 二 个 测试 与 第 一 个 测试 类 似 ， 不 过 这 次 传 入 两 个 完全 相同 的 带 有 噪音 
// 并 伴随 强 正直 流 偏 移 的 m4a 文 件 ， 这 项 测试 也 是 为 了 探测 是 否 存 在 播放 缺口 
public void testGapless2() throws Exception { 
flakyTestWrapper (R.raw.stereonoisedcpos, R.raw.stereonoisedcpos) 
} 
// xuben: 与 上 面 测试 相同 ， 不 过 此 处 传 入 参数 挠 成 mono 文 件 
public void testGapless3() throws Exception { 
flakyTestWrapper (R.raw.mononoisedcpos, R.raw.mononoisedcpos) 


} 





用 flakyTestWrapper() 方 法 进行 测试 的 。 下 面 我 们 一 起 来 看 看 这 个 方法 ， 如 代码 清单 12-11 所 示 








前 面 传 入 的 文件 虽然 都 比较 奇 范 ， 不 过 均 是 调 


代码 清单 12-11 MediaPlayerTest::flakyTestWrapper() 





private void flakyTestWrapper(int residl, int resid2) throws Exception ( 
boolean success - false; 
// xuben: d T4 A4 AR ds, PPA ACE I ELEC DE AC 
// 需要 多 测 几 次 才能 成 功 ， 所 以 此 处 循环 20 次 进行 测试 
for(int i = 0; i < 20 && !success; i++) { 
try { 
// xuben: 调用 testGapless () 传 入 文件 进行 测试 ， 下 一 节 将 详 述 
testGapless (residl, resid2); 
success = true; 
) catch(Throwable t) ( 
SystemClock.sleep (1000); 
} 


} 
// xuben: 循环 20 次 后 ， 再 单独 测试 一 次 ， 若 此 次 成 功 ， 
// 则 我 们 认定 其 成 功 ， 否 则 抛 异常 
if(!success) ( 
testGapless (residl, resid2); 
} 
} 





SS% 这 的 确 是 个 非常 奇 苑 的 测试 ， 想 不 到 也 能 通过 单元 测试 来 执行 ， 牛 ! 


频谱 测试 如 图 12-7 所 示 。 





无 声 并 伴随 强 正直 流 偏 移 的 mp3 文 件 
f ] 无 声 并 伴随 强 负 下 流 偏 移 的 mp3 文 件 
_ 播放 缺 口 测试 O 若 这 两 个 文件 出 现 播放 重合 RES OH 并 探测 到 零 什 


若 存在 播放 缺口 ， 也 将 探测 到 零 什 


传 入 两 个 完全 相同 的 带 有 噪音 
_ 并 伴随 强 正直 流 偏 移 的 m4a 文 件 


* SEBGADUM O 大汉 两 个 文件 出 现 播放 重要 播放 将 取消 ,并 探测 到 零 值 
若 存在 播放 缺口 ， 也 将 探测 到 零 什 





传 入 两 个 完全 相同 的 带 有 噪音 
并 伴随 强 正直 流 偏 移 的 mono 文 件 


“播放 缺口 测试 3 “= | 若 这 两 个 文件 出 现 播放 重生 播放 将 取消 ,并 探测 到 零 值 
若 存 在 播放 缺口 ， 也 将 探测 到 零 人 


12-7 频谱 测试 




















12.2.6 ”无 颖 播放 测试 














上 一 节 的 几 个 播放 文件 固然 奇 苑 ， 但 若 没 有 对 无 颖 播放 测试 方法 的 调用 ， 再 奇 区 的 文件 也 发 现 不 了 太 多 问题 一 一 无 颖 播放 ， 即 提供 相同 的 音频 参数 连续 剪辑 。 下 面 就 来 看 看 这 个 无 颖 播放 测试 方法 ， 如 
代码 清单 12-12 所 示 。 


代码 清单 12-12 无 颖 播放 测试 





private void testGapless(int residl, int resid2) throws Exception { 

MediaPlayer mpl = new MediaPlayer(); 

mpl.setAudioStreamType (AudioManager.STREAM MUSIC); 

try { 
// xuben: 检验 传 入 参数 数据 源 正确 ， 此 处 为 参数 1， 后 续 参 数 2 亦 同 
AssetFileDescriptor afd = mContext.getResources ().openRawResourceFd (residl); 
// xuben: 指定 装载 afd 所 代表 的 文件 〔 即 参数 1 所 传 入 文件 ) 中 从 
// ofset 开 始 、 长 度 为 参数 1 所 传 文件 长 度 的 文件 内 容 给 播放 器 mp1 
mpl.setDataSource (afd.getFileDescriptor(), afd.getStartOfset(), afd.getLength()); 
afd.close(); 
mpl.prepare(); 

} catch(Exception e) { 
assertTrue (false); 


$ 
// xuben: 获取 播放 器 mp1 的 SessionId 
int session = mpl.getAudioSessionId(); 
MediaPlayer mp2 = new MediaPlayer(); 
// xuben: 将 播放 器 mp1 的 SessionId 传 给 播放 器 mp2 
mp2.setAudioSessionId (session); 
mp2.setAudioStreamType (AudioManager.STREAM MUSIC); 
try ( 
// xuben: 指定 装载 afd 所 代表 的 文件 ( 即 参数 2 所 传 入 文件 ) 中 
// 从 ofset 开 始 、 长 度 等 于 参数 2 所 传 文件 长 度 的 文件 给 播放 器 mp2 
AssetFileDescriptor afd = mContext.getResources () .openRawResourceFd (resid2) ; 
mp2.setDataSource (afd.getFileDescriptor(), afd.getStartOfset(), afd.getLength()); 
afd.close(); 
mp2.prepare(); 
] catch(Exception e) ( 
assertTrue (false); 
l 
// xuben: 为 输出 文件 创建 音量 控制 器 以 确保 
// 静音 设置 是 在 测试 后 才 生 效 (而 非 测试 前 生效 ) 
AudioEfect vc = new AudioEfect( 
AudioEfect.EfECT TYPE NULL, 
UUID. fromString ("119341a0-8469-11df-81f9-0002a5d5c51b"), 
0, 
session); 
vc.setEnabled (true); 
int captureintervalms = mpl.getDuration() + mp2.getDuration() - 2000; 
int size = 256; 
int[] range = Visualizer.getCaptureSizeRange () ; 
if(size < range[0]) { 
size - range[0]; 
l 
if(size » range[1]) ( 
size = range[1]; 


} 

byte [] vizdata = new byte[size]; 

// xuben: 通过 session 实 例 化 Visualizer 
Visualizer vis = new Visualizer (session); 


// xuben: 设置 需要 转换 的 音乐 内 容 长 度 ， 并 确定 其 设置 成 功 


assertTrue (vis.setCaptureSize (vizdata.length) == Visualizer.SUCCESS); 


assertTrue (vis.setEnabled (true) 


AudioManager am =(AudioManager) mContext 
.getSystemService (Context .AUDIO SERVICE); 
int oldRingerMode - am.getRingerMode(); 
am.setRingerMode (AudioManager.RINGER MODE NORMAL); 
int oldvolume = am.getStreamVolume (AudioManager .STREAM MUSIC); 


am.setStreamVolume (AudioManager.STREAM MUSIC, 1, 0); 


try { 


mpl.setNextMediaPlayer (mp2); 


mpl.start(); 


assertTrue (mpl.isPlaying()); 

assertFalse (mp2.isPlaying()); 

// allow playback to get started 

Thread.sleep(SLEEP TIME); 

long start = SystemClock.elapsedRealtime () ; 
i xuben: 当 切 换 音频 文件 时 ，bufer 中 不 能 出 现 连 续 为 0 的 


/ 情况 ( 即 vizdata[] 数组 中 连续 两 个 值 为 -128) , 


/ 测试 失败 ， 失 败 原因 有 两 
// 1. 此 时 设备 为 静音 模式 ， 


种 : 
需要 调 高 音量 后 重 测 


// 2. 音 频 文件 存在 gap 或 overlap 


boolean first = true; 


若 出 现 则 


== Visualizer.SUCCESS); 


while((SystemClock.elapsedRealtime() - start) < captureintervalms) { 
assertTrue (vis. getWaveForm (vizdata) == Visualizer.SUCCESS) ; 
for(int i = 0; i < vizdata.length - 1; i++) { 
if (vizdata[i] == -128 && vizdata[i + 1] == -128) { 
if(first) { 
fail("silence detected, please increase volume and rerun test"); 
} else { 
fail("gap or overlap detected at t=" + 
(SLEEP TIME + SystemClock.elapsedRealtime() - start) 十 
", ofset "+ i); 


} 
break; 
} 
} 
first = false; 


lj 
) finally ( 
mpl.release(); 
mp2.release(); 
vis.release(); 
vc.release(); 


am.setRingerMode (oldRingerMode); 
am.setStreamVolume (AudioManager.STREAM MUSIC, oldvolume, 0); 





全 无 颖 播放 失败 ， 还 页 不 一 定 是 bug， 所 以 测试 手机 的 音 





无 颖 播放 测试 ， 如 图 12-8 所 示 。 











。 测试 资源 准备 





12.2.7 ”视频 界面 重 置 测试 


o 测试 失败 原因 








对 于 视频 而 言 ， 在 播放 过 程 中 











代码 清单 12-13 ”视频 界面 重 置 测试 





户 总 会 去 调整 其 界 





面 大 小 ， 


一 。 切换 音频 文件 = 


甚至 


m 


指定 装载 afd 所 代表 的 文件 ( 即 参数 1 所 传 入 文件 ) 中 从 
offset 开 始 、 长 度 为 参数 1 所 传 文件 长 度 的 文件 内 容 给 播放 器 mp1 


-获取 播放 器 mp1 的 SessionId 


指定 装载 afd 所 代表 的 文件 ( 即 参数 2 所 传 入 文件 ) 中 


从 offset 开 始 、 长 度 为 参数 2 所 传 文件 长 度 的 文件 内 容 给 播放 器 mp2 


为 输出 文件 创建 音量 控制 器 以 确保 静音 
设置 是 在 测试 后 才 生 效 ( 而 非 测 试 前 生效 ) 


设置 需要 转换 的 音乐 内 容 长 度 ， 并 确定 其 设置 成 功 

















当 切 换 音 频 文件 时 ，buffer 中 不 能 出 现 连 续 为 0 的 
情况 ( 即 vizdata[] 数 组 中 连续 两 个 值 为 -128 ) 


若 出 现 则 测试 失败 








重 置 界面 ， 但 无 论 界面 如 何 调整 或 有 


E 置 ， 都 不 应 该 影响 播放 进程 ， 视 频 界面 





(ARRAL : 此 时 设备 为 静音 模式 ， 需 要 调 高 音量 后 重 测 
“失败 原因 2: : 音频 文件 存在 gap 或 overlap 


12-8 无 缝 播放 测试 


E 置 测试 如 代码 清单 12-13 所 示 。 





public void testVideoSurfaceResetting() throws Exception ( 


final int tolerance - 150; 


final int audioLatencyTolerance = 1000; /* covers audio path latency variability */ 


final int seekPos = 5000; 
final CountDownLatch seekDone = new CountDownLatch (1); 


mMediaPlayer.setOnSeekCompleteListener (new MediaPlayer.OnSeekCompleteListener() { 


GOverride 


public void onSeekComplete (MediaPlayer mp) ( 


seekDone. countDown(); 


} 
n; 


loadResource (R.raw.testvideo); 


playLoadedVideo (352, 288, 


Thread. sleep (SLEEP TIME); 


-1); 


// xuben: 获取 设置 屏幕 前 后 播放 文件 位 置 ， 
// setDisplay () 方法 设置 用 于 显示 媒体 视频 的 SurfaceHolder。 这 个 调用 是 可 选 的 ， 


// 只 显示 音频 而 不 显示 视频 时 不 调用 这 个 方法 (例如 后 台 播 放 ) 
int posBefore = mMediaPlayer.getCurrentPosition(); 


mMediaPlayer.setDisplay (getActivity () .getSurfaceHolder2 ()); 


int posAfter = mMediaPlayer.getCurrentPosition(); 


// xuben: 测试 设置 屏幕 前 后 播放 位 置 不 受 影响 ， 

// 即 播放 视频 文件 进度 不 受 屏幕 设置 干扰 上 且 此 时 视频 仍 处 于 播放 状态 
assertEquals (posAfter, posBefore, tolerance); 

assertTrue (mMediaPlayer.isPlaying()); 

Thread. sleep (SLEEP TIME); 

// xuben: 将 视频 跳 转 到 seekPos 位 置 ， 并 获取 当前 视频 位 置 ， 

// 此 时 当前 位 置 应 等 同 于 跳 转 位 置 (允许 延迟 ) 
mMediaPlayer.seekTo (seekPos) ; 

seekDone.await(); 

posAfter = mMediaPlayer.getCurrentPosition(); 
assertEquals (seekPos, posAfter, tolerance + audioLatencyTolerance); 
// xuben: 将 setDisplay() 方 法 置 空 ， 此 时 播放 进度 仍 不 应 该 受 影响 ， 
// 且 视 频仍 处 于 播放 状态 

Thread.sleep(SLEEP TIME / 2); 

posBefore = mMediaPlayer.getCurrentPosition(); 
mMediaPlayer.setDisplay (null); 

posAfter - mMediaPlayer.getCurrentPosition(); 
assertEquals (posAfter, posBefore, tolerance); 

assertTrue (mMediaPlayer.isPlaying()); 

Thread. sleep (SLEEP TIME); 

// xuben: 再 次 调整 其 界面 大 小 ， 此 时 播放 进度 仍 不 应 该 受 影响 ， 

// 且 视 频仍 处 于 播放 状态 

posBefore = mMediaPlayer.getCurrentPosition(); 
mMediaPlayer.setDisplay (getActivity () .getSurfaceHolder()); 
posAfter = mMediaPlayer.getCurrentPosition(); 
assertEquals (posAfter, posBefore, tolerance); 

assertTrue (mMediaPlayer.isPlaying()); 

Thread.sleep(SLEEP TIME); 








播放 器 界面 重 置 这 种 小 概率 事件 谷歌 大 牛 们 也 考虑 到 了 ! 








视频 界面 重 置 测试 ， 如 图 12-9 所 示 。 

















一 ”预先 设置 








12.2.8 “录制 视频 播放 角度 测试 








获取 设置 屏幕 前 后 播放 文件 位 置 setDisplay() 方 法 
设置 用 于 显示 媒体 视频 的 SurfaceHolder。 这 个 调用 是 可 选 的 ， 
3 只 显示 音频 而 不 显示 视频 时 不 调用 这 个 方法 ( 例如 后 台 播 放 ) 


测试 设置 屏幕 前 后 播放 位 置 不 受 影响 ， 即 播放 视频 文件 进度 
不 受 屏幕 设置 干扰 且 此 时 视频 仍 处 于 播放 状态 


将 视频 跳 转 到 seekPos 位 置 ， 并 获取 当前 视频 位 置 ， 
此 时 当前 位 置 应 等 同 于 跳 转 位 置 ( 允许 延迟 ) 


_ 将 setDisplay0 方 法 置 空 ， 此 时 播放 进度 仍 不 应 该 受 影响 ， 


”实际 测试 “电视 频仍 处 于 播放 状态 


再 次 调整 其 界面 大 小 ， 此 时 播放 进度 仍 不 应 该 受 影响 ， 
且 视 频仍 处 于 播放 状态 


12-9 ”视频 界面 重 置 测 试 














对 于 视频 而 言 ， 在 播放 过 程 中 用 户 总 习惯 旋转 屏幕 ， 无 论 界面 如 何 旋转 ， 都 不 应 该 影响 播放 进程 ， 录 制 视频 播放 角度 测试 如 代码 清单 12-14 所 示 。 








代码 清单 12-14 ”录制 视频 播放 角度 测试 





// xuben: 录制 视频 0 度 播放 
public void testRecordedVideoPlayback0() throws Exception { 


// xuben: 播放 角度 测试 都 是 通过 调用 testRecordedVideoPlaybackWithAngle() 


// 方法 实现 ， 稍 后 详 述 
testRecordedVideoPlaybackWithAngle (0) ; 


} 

// xuben: 录制 视频 90 度 播放 

public void testRecordedVideoPlayback90() throws Exception { 
testRecordedVideoPlaybackWithAngle (90) ; 


l 

// xuben: 录制 视频 180 度 播放 

public void testRecordedVideoPlayback180() throws Exception { 
testRecordedVideoPlaybackWithAngle (180) ; 


} 

// xuben: 录制 视频 270 度 播放 

public void testRecordedVideoPlayback270() throws Exception { 
testRecordedVideoPlaybackWithAngle (270) ; 

} 











代码 清单 12-15 ”检测 相机 功能 模块 


首先 ， 需 要 检查 设备 是 否 具有 相机 功能 模块 ， 若 无 相机 ， 也 就 无 法 录制 视频 ， 则 无 需 此 测试 ， 如 代码 清单 12-15 所 示 。 





// xuben: 检查 设备 是 否 具有 相机 功能 模块 
private boolean hasCamera() { 
return getActivity() .getPackageManager () 


-hasSystemFeature (PackageManager.FEATURE CAMERA); 





录制 视频 播放 角度 测试 ， 如 代码 清单 12-16 所 示 。 


代码 清单 12-16 录制 视频 播放 角度 测试 





private void testRecordedVideoPlaybackWithAngle (int angle) throws Exception { 


final int width — RECORDED VIDEO WIDTH; 
final int height = RECORDED VIDEO HEIGHT; 
final String file = RECORDED FILE; 


final long durationMs = RECORDED DURATION MS; 
// xuben: 若 相 机 功能 模块 缺失 ， 则 无 需 测试 
if(!hasCamera()) { 

return; 


l 

// xuben: 检验 参数 角度 是 否 符合 要 求 

checkOrientation (angle); 

// xuben: 录制 视频 

recordVideo (width, height, angle, file, durationMs); 
checkDisplayedVideoSize (width, height, angle, file); 
checkVideoRotationAngle (angle, file); 





检验 参数 角度 是 否 符合 要 求 ， 如 代码 清单 12-17 所 示 。 


代码 清单 12-17 ”检验 参数 角度 





// xuben: 参数 角度 必须 在 0 度 到 360 度 之 间 ， 且 必须 为 0 度 或 90 度 的 整数 倍 等 
private void checkOrientation(int angle) throws Exception ( 
assertTrue (angle »- 0); 
assertTrue (angle « 360); 
assertTrue((angle $ 90) == 0); 





视频 录制 ， 如 代码 清单 12-18 所 示 。 


代码 清单 12-18 ”视频 录制 





private void recordVideo( 
int w, int h, int angle, String file, long durationMs) throws Exception [ 
// xuben: 创建 录制 视频 对 象 并 进行 基本 设置 ， 将 录制 视频 路 径 保存 在 File 参数 中 
MediaRecorder recorder = new MediaRecorder () ; 
recorder. setVideoSource (MediaRecorder .VideoSource.CAMERA) ; 
recorder. setAudioSource (MediaRecorder .AudioSource.MIC) ; 
recorder. setOutputFormat (MediaRecorder.OutputFormat.DEFAULT); 
recorder. setVideoEncoder (MediaRecorder .VideoEncoder . DEFAULT) ; 
recorder. setAudioEncoder (MediaRecorder .AudioEncoder .DEFAULT) ; 
recorder. setOutputFile (file); 
recorder.setOrientationHint (angle) ; 
recorder.setVideoSize(w, h); 
recorder.setPreviewDisplay (getActivity() .getSurfaceHolder2 () .getSurface()); 
// xuben: 开始 录制 ， 录 制 时 间 为 QurationMs， 此 处 预 设 为 3 秒 
recorder.prepare(); 
recorder.start(); 
Thread.sleep (durationMs); 
recorder.stop(); 
recorder.release(); 
recorder - null; 








视频 大 小 检验 ， 此 处 通过 调用 父 类 的 playVideoTest( 方 法 进行 检测 ， 如 代码 清单 12-19 所 示 。 


代码 清单 12-19 ”视频 大 小 检验 





private void checkDisplayedVideoSize ( 
int w, int h, int angle, String file) throws Exception ( 
// xuben: 若 旋转 为 180 度 的 整数 倍 〈0 度 ，180 度 ) , 
// 则 将 视频 长 、 宽 颠倒 ， 否 则 无 需 颠 倒 
int displayWidth = w; 
int displayHeight - h; 
if((angle $ 180) 0) ( 
displayWidth = h; 
displayHeight = w; 








$ 
// xuben: 调用 父 类 MediaPlayerTestBase 中 的 PlayVideoTest () 方法 进行 检测 
playVideoTest (file, displayWidth, displayHeight); 





播放 角度 检查 ， 如 代码 清单 12-20 所 示 。 


代码 清单 12-20 “播放 角度 检查 





private void checkVideoRotationAngle (int angle, String file) ( 
MediaMetadataRetriever retriever = new MediaMetadataRetriever (); 
retriever.setDataSource (file); 
// xuben: 提取 播放 文件 的 角度 METADATA KEY VIDEO ROTATION 
String rotation = retriever.extractMetadata ( 

MediaMetadataRetriever.METADATA KEY VIDEO ROTATION); 

retriever.release(); —~= = 
retriever = null; 
// xuben: 播放 文件 的 角度 不 能 为 空 
assertNotNull (rotation); 
// xuben: 将 播放 文件 的 角度 METADATA KEY VIDEO ROTATION 
// 应 与 传 入 角度 保持 一 致 


assertEquals (Integer.parseInt (rotation), angle); 





SBA A, REA, AA! 





录制 视频 播放 角度 测试 ， 如 图 12-10 所 示 。 














12.2.9 ”不同 格式 视频 文件 测试 


设备 是 否 具 有 相机 功能 模块 


录制 前 检查 O 检验 参数 角度 是 否 符合 要 求 


录制 视频 0 度 播 放 
[录制 视频 90 度 播放 
(MSIE 录制 视频 180 度 播放 


录制 视频 270 度 播放 








视频 大 小 检验 


录制 后 检查 JO Latet ret git 


图 12-10 录制 视频 播放 角度 测试 


这 里 需要 考虑 到 各 种 不 同 格式 的 播放 文件 (类 型 、 编 码 格式 、 分 辨 率 、 比 特 率 、 帧 率 、 音 频 格 式 、 声 道 和 频率 等 ) ， 如 代码 清单 12-21 所 示 。 


代码 清单 12-21 不 同 格式 视频 文件 测试 





// xuben: 如 下 测试 均 通 过 调用 playVideoTest () 方法 对 各 种 不 同 格式 的 
// 播放 文件 (类 型 、 编 码 格 式 、 分 辩 率 、 比 特 率 、 帧 率 、 音 频 格 式 、 
// 声 道 和 频率 等 ) 进行 测试 
public void testLocalVideo MP4 H264 480x360 500kbps 25fps AAC Stereo 128kbps 44110Hz() 
throws Exception ( ^ 7 m dde 
playVideoTest ( 
R.raw.video 480x360 mp4 h264 500kbps 25fps aac stereo 128kbps 44100hz 
,480 , 360); 
} 
public void testLocalVideo MP4 H264 480x360 500kbps 30fps AAC Stereo 128kbps 44110Hz() 
throws Exception ( 
playVideoTest ( 
R.raw.video 480x360 mp4 h264 500kbps 30fps aac stereo 128kbps 44100hz 
, 480, 360); 
} 
public void testLocalVideo MP4 H264 480x360 1000kbps 25fps AAC Stereo 128kbps 44110Hz() 
throws Exception ( ^ 7 x x ~ 7 ~ a 
playVideoTest ( 
R.raw.video 480x360 mp4 h264 1000kbps 25fps aac stereo 128kbps 44100hz 
, 480, 360); 
} 
public void testLocalVideo MP4 H264 480x360 1000kbps 30fps AAC Stereo 128kbps 44110Hz() 
throws Exception ( ^ 7 = T ~ 
playVideoTest ( 
R.raw.video 480x360 mp4 h264 1000kbps 30fps aac stereo 128kbps 44100hz 
, 480, 360); 
} 
public void testLocalVideo MP4 H264 480x360 1350kbps 25fps AAC Stereo 128kbps 44110Hz() 
throws Exception ( 
playVideoTest ( 
R.raw.video 480x360 mp4 h264 1350kbps 25fps aac stereo 128kbps 44100hz 
, 480, 360); 
} 
public void testLocalVideo MP4 H264 480x360 1350kbps 30fps AAC Stereo 128kbps 44110Hz() 
throws Exception ( = I 5 2 eS z 7 ~ = 
playVideoTest ( 
R.raw.video 480x360 mp4 h264 1350kbps 30fps aac stereo 128kbps 44100hz 
, 480, 360); 
} 
public void testLocalVideo MP4 H264 480x360 1350kbps 30fps AAC Stereo 192kbps 44110Hz() 
throws Exception { 
playVideoTest ( 
R.raw.video 480x360 mp4 h264 1350kbps 30fps aac stereo 192kbps 44100hz 
, 480, 360); 
} 
public void testLocalVideo 3gp H263 176x144 56kbps 12fps AAC Mono 24kbps 11025Hz() 
throws Exception ( ^ 7 = = nk E 
playVideoTest ( 
R.raw.video 176x144 3gp h263 56kbps 12fps aac mono 24kbps 11025hz 
, 176, 144); 
} 
public void testLocalVideo 3gp H263 176x144 56kbps 12fps AAC Mono 24kbps 22050Hz() 
throws Exception ( ^ 7 T ~ T ~ 7 ~ T 
playVideoTest ( 
R.raw.video 176x144 3gp h263 56kbps 12fps aac mono 24kbps 22050hz 
, 176, 144); ute T T a T ~ 
} 
public void testLocalVideo 3gp H263 176x144 56kbps 12fps AAC Stereo 24kbps 11025Hz() 
throws Exception ( 
playVideoTest ( 
R.raw.video 176x144 3gp h263 56kbps 12fps aac stereo 24kbps 11025hz 
, 176, 144); m ui = g T 
} 
public void testLocalVideo 3gp H263 176x144 56kbps 12fps AAC Stereo 24kbps 22050Hz() 
throws Exception { ` 7 xs T ~ m 
playVideoTest ( 
R.raw.video 176x144 3gp h263 56kbps 12fps aac stereo 24kbps 11025hz 
, 176, 144); 
} 
public void testLocalVideo 3gp H263 176x144 56kbps 12fps AAC Stereo 128kbps 11025Hz() 
throws Exception ( ^ . a = = — = i 
playVideoTest ( 
R.raw.video 176x144 3gp h263 56kbps 12fps aac stereo 128kbps 11025hz 
, 176, 144); TES T ~ 3 7 n T 
} 
public void testLocalVideo 3gp H263 176x144 56kbps 12fps AAC Stereo_128kbps_22050Hz () 
throws Exception { 
playVideoTest ( 
R.raw.video 176x144 3gp h263 56kbps 12fps aac stereo 128kbps 11025hz 
, 176, 144); 


public void testLocalVideo 3gp H263 176x144 56kbps 25fps AAC Mono 24kbps 11025Hz () 
throws Exception ( ^ 7 v E iom ys C 
playVideoTest ( 
R.raw.video 176x144 3gp h263 56kbps 25fps aac mono 24kbps 11025hz 
, 176, 144); bis =< £y se T 2 
} 
public void testLocalVideo 3gp H263 176x144 56kbps 25fps AAC Mono 24kbps 22050Hz() 
throws Exception ( 
playVideoTest ( 
R.raw.video 176x144 3gp h263 56kbps 25fps aac mono 24kbps 22050hz 
, 176, 144); ddp d B zm < > B 
$ 
public void testLocalVideo 3gp H263 176x144 56kbps 25fps AAC Stereo 24kbps 11025Hz() 
throws Exception ( ^ 7 E 3 = arig ~ B 
playVideoTest ( 
R.raw.video 176x144 3gp h263 56kbps 25fps aac stereo 24kbps 11025hz 
, 176, 144); 
} 
public void testLocalVideo 3gp H263 176x144 56kbps 25fps AAC Stereo 24kbps 22050Hz() 
throws Exception ( 
playVideoTest ( 
R.raw.video 176x144 3gp h263 56kbps 25fps aac stereo 24kbps 11025hz 
, 176, 144); CU T ~ T T D 
} 
public void testLocalVideo 3gp H263 176x144 56kbps 25fps AAC Stereo 128kbps 11025Hz() 
throws Exception ( 
playVideoTest ( 
R.raw.video 176x144 3gp h263 56kbps 25fps aac stereo 128kbps 11025hz 
, 176, 144); 
} 
public void testLocalVideo 3gp H263 176x144 56kbps 25fps AAC Stereo 128kbps 22050Hz() 
throws Exception ( ^ 7 ~ E B s Ey a 
playVideoTest ( 
R.raw.video 176x144 3gp h263 56kbps 25fps aac stereo 128kbps 11025hz 
, 176, 144); Rid = = =F zi T 
} 
public void testLocalVideo 3gp H263 176x144 300kbps 12fps AAC Mono 24kbps 11025Hz() 
throws Exception ( 
playVideoTest ( 
R.raw.video 176x144 3gp h263 300kbps 12fps aac mono 24kbps 11025hz 
, 176, 144); E 7 p) pL B a 
} 
public void testLocalVideo 3gp H263 176x144 300kbps 12fps AAC Mono 24kbps 22050Hz () 
throws Exception ( ^ 7 s E nd e B d 
playVideoTest ( 
R.raw.video 176x144 3gp h263 300kbps 12fps aac mono 24kbps 22050hz 
, 176, 144); 
} 
public void testLocalVideo 3gp H263 176x144 300kbps 12fps AAC Stereo 24kbps 11025Hz() 
throws Exception ( ^ 7 7 = 5 vice T i 
playVideoTest ( 
R.raw.video 176x144 3gp h263 300kbps 12fps aac stereo 24kbps 11025hz 
, 176, 144); REDE T ~ pr ad 
} 
public void testLocalVideo 3gp H263 176x144 300kbps 12fps AAC Stereo 24kbps 22050Hz() 
throws Exception ( 
playVideoTest ( 
R.raw.video 176x144 3gp h263 300kbps 12fps aac stereo 24kbps 11025hz 
, 176, 144); uipa T a m e = 
į 
public void testLocalVideo 3gp H263 176x144 300kbps 12fps AAC Stereo 128kbps 11025Hz() 
throws Exception ( ^ 7 > T 2 "a ex a x: 
playVideoTest ( 
R.raw.video 176x144 3gp h263 300kbps 12fps aac stereo 128kbps 11025hz 
, 176, 144); 
} 
public void testLocalVideo 3gp H263 176x144 300kbps 12fps AAC Stereo 128kbps 22050Hz() 
throws Exception ( 
playVideoTest ( 
R.raw.video 176x144 3gp h263 300kbps 12fps aac stereo 128kbps 11025hz 
, 176, 144); md 7 | E © T x 
} 
public void testLocalVideo 3gp H263 176x144 300kbps 25fps AAC Mono 24kbps 11025Hz() 
throws Exception ( 
playVideoTest ( 
R.raw.video 176x144 3gp h263 300kbps 25fps aac mono 24kbps 11025hz 
, 176, 144); 
} 
public void testLocalVideo 3gp H263 176x144 300kbps 25fps AAC Mono 24kbps 22050Hz () 
throws Exception ( > a T NL z z 
playVideoTest ( 
R.raw.video 176x144 3gp h263 300kbps 25fps aac mono 24kbps 22050hz 
, 176, 144); puis, ig ig aC u Nu 
} 
public void testLocalVideo 3gp H263 176x144 300kbps 25fps AAC Stereo 24kbps 11025Hz() 
throws Exception ( 
playVideoTest ( 
R.raw.video 176x144 3gp h263 300kbps 25fps aac stereo 24kbps 11025hz 
, 176, 144); rss ee A EAT g = 
} 
public void testLocalVideo 3gp H263 176x144 300kbps 25fps AAC Stereo 24kbps 22050Hz() 
throws Exception ( ^ 7 i = g b = p 
playVideoTest ( 
R.raw.video 176x144 3gp h263 300kbps 25fps aac stereo 24kbps 11025hz 
, 176, 144); 
} 
public void testLocalVideo 3gp H263 176x144 300kbps 25fps AAC Stereo 128kbps 11025Hz() 
throws Exception ( ^ 7 = F^ = a B iz 
playVideoTest ( 
R.raw.video 176x144 3gp h263 300kbps 25fps aac stereo 128kbps 11025hz 
, 176, 144); pir EE E Ur xs yx m 
} 
public void testLocalVideo 3gp H263 176x144 300kbps 25fps AAC Stereo _128kbps_22050Hz () 
throws Exception ( 
playVideoTest ( 
R.raw.video 176x144 3gp h263 300kbps 25fps aac stereo 128kbps 22050hz 
, 176, 144); 














根据 传 入 参数 ， 总 结 如 下 ， 如 有 遗漏 敬 请 补充 一 一 大 家 可 以 自行 分 析 一 下 ， 该 单元 测试 用 例 设计 水 平 如 何 ， 是 否 涵盖 了 绝 大 部 分 文件 类 型 ， 是 否 包含 了 所 有 组 合 ， 如 























12-11 所 示 。 





图 12-11 不 同 格 式 视频 文件 





人 < 奔 可 ， 你 总 结 起 来 怎么 这 么 少 ， 实 际 的 测试 项 为 什么 又 这 么 多 啊 ? 
85... unus 量 啊 ， 哈 哈 ! 


小 插曲 : 视频 播放 测试 


前 面 的 视频 测试 大 多 调用 了 父 类 MediaPlayerTestBase 的 playVideoTest0 方 法 进行 检测 ， 下 面 让 我 们 一 起 看 看 这 














代码 清单 12-22 ”视频 播放 测试 


看 这 个 视频 测试 方法 ， 如 代码 清单 12-22 所 示 。 





// xuben: 传 入 第 一 个 参数 若 为 文件 路 径 (string 型 ) ， 则 需 调 用 playVideoWithRetries() 
protected void playVideoTest (String path, int width, int height) throws Exception { 
ee ae ale see pur width, height, 0); 
3 xuben: 传 入 第 一 个 参数 若 为 文件 idq， 则 需 调 用 LIoadResource () 和 playLoadedVideo () 
protected void playVideoTest (int resid, int width, int height) throws Exception { 


loadResource (resid) ; 
playLoadedVideo (width, height, 0); 


} 








下 面 先 来 看 看 playVideoWithRetries() 方 法 ， 如 代码 清单 12-23 所 示 。 


代码 清单 12-23 playVideoWithRetries() 





protected void playVideoWithRetries (String path, Integer width 
, Integer height, int playTime) 


throws Exception ( 
boolean playedSuccessfully - false; 
// xuben: 反复 尝试 多 次 (此 处 为 20 次 ) ， 若 播放 成 功 则 跳出 循环 
for(int i = 0; i < STREAM RETRIES; i++) { 
try { 
// xuben: 由 于 传 入 的 是 文件 路 径 ， 所 以 直接 根据 路 径 获取 播放 文件 
mMediaPlayer.setDataSource (path); 
// xuben: i&iitplayLoadedVideo () 方法 播放 文件 ， 稍 后 详 述 
playLoadedVideo (width, height, playTime); 
playedSuccessfully - true; 
break; 


) catch(PrepareFailedException e) ( 
// prepare() can fail because of network issues, so try again 


LOG.warning("prepare() failed on try "+ i+ ", trying playback again"); 
} 
l 
assertTrue ("Stream did not play successfully after all attempts 
, playedSuccessfully); 




















不 难 发 现 ，playVideoWithRetries() 方 法 和 通过 id 调 有 


代码 清单 12-24 playLoadedVideo() 


播放 文件 的 playVideoTest() 方 法 均 调用 了 playLoadedVideo() 方 法 ， 下 面 一 起 来 看 看 ， 如 代码 


青 单 12-24 所 示 。 








protected void playLoadedVideo(final Integer width, final Integer height, int playTime) 
throws Exception { 
final float leftVolume = 0.5f; 
final float rightVolume = 0.5f; 
// xuben: 设置 视频 播放 界面 
mMediaPlayer.setDisplay (mActivity.getSurfaceHolder ()); 
// xuben: Jb X AS REX E je, AAA 
mMediaPlayer.setScreenOnWhilePlaying (true); 
// xuben: 设置 视频 大 小 已 知 或 更 新 后 调用 监听 器 
mMediaPlayer.setOnVideoSizeChangedListener (new 
MediaPlayer.OnVideoSizeChangedListener() ( 
GOverride 
public void onVideoSizeChanged (MediaPlayer mp, int w, int h) ( 
if(w == 0 && h = 0) { 
// xuben: 当 使 用 NuPlayer 播 放 时 ， 视 频 宽 高 均 为 0， 此 时 
// monVideoSizeChangedCalled 处 于 未 标记 状态 
assertFalse (mOnVideoSizeChangedCalled.isSignalled()); 
return; 

} 
mOnVideoSizeChangedCalled.signal (); 
if(width != null) { 

assertEquals (width.intValue(), w); 


} 
if(height != null) { 
assertEquals (height.intValue(), h); 
} 
} 


1; 
// zuben: 异步 操作 调用 过 程 中 的 错误 监听 器 ， 如 视频 打开 失败 
mMediaPlayer.setOnErrorListener (new MediaPlayer.OnErrorListener() { 
GOverride 
public boolean onError(MediaPlayer mp, int what, int extra) ( 
fail("Media player had error " + what + " playing video"); 
return true; 
} 
1; 
// xuben: 警告 或 错误 信息 监听 器 ， 如 开始 缓冲 、 缓 冲 结束 、 下 载 速度 变化 等 
mMediaPlayer.setOnInfoListener (new MediaPlayer.OnInfoListener() ( 
GOverride 
public boolean onInfo(MediaPlayer mp, int what, int extra) ( 
if(what 一 MediaPlayer.MEDIA INFO VIDEO RENDERING START) { 
mOnVideoRenderingStartCalled.signal (); 
} 
return true; 
} 
1; 
// xuben: 准备 播放 器 
try { 
mMediaPlayer.prepare () ; 
} catch(IOException e) { 
mMediaPlayer. reset (); 
throw new PrepareFailedException(); 


l 
// xuben: 开始 播放 ， 并 设置 音量 (范围 0.0~1.0 之 间 ， 此 处 为 0.5f) 
mMediaPlayer.start(); 
mOnVideoSizeChangedCalled.waitForSignal(); 
mOnVideoRenderingStartCalled.waitForSignal (); 
mMediaPlayer.setVolume (leftVolume, rightVolume) ; 
// xuben: 等 待 播放 完成 
if(playTime == -1) ( 

return; 
] else if(playTime == 0) ( 

while (mMediaPlayer.isPlaying()) { 

Thread.sleep(SLEEP TIME); 

} 
) else ( 

Thread. sleep (playTime) ; 
} 
mMediaPlayer.stop(); 





具体 步骤 如 下 。 





1) 播放 界面 设置 : 通过 setDisplay0 方 法 进行 视频 播放 界面 设置 。 

















2) 持续 播放 视频 : 通过 setScreenOnWhilePlayfing0 方 法 设置 保持 屏幕 高 亮 持 续 播放 视频 。 





























3) 视频 大 小 更 新 监听 器 设置 : 通过 setOnVideoSizeChangedListener() 方 法 设置 视频 尺寸 更 新 监听 器 。 当 使 用 NuPlayer 播 放 时 视频 宽 高 均 为 0%， 此 时 mOnVideoSizeChangedCalled 处 于 未 标记 状 




















4) 出 错 监听 器 设置 : 通过 setOnErrorListener() 方 法 设置 异步 操作 调用 过 程 中 的 出 错 监 听 器 ， 如 视频 打开 失败 。 








5) 警告 或 错误 信息 监听 器 设置 : 通过 setOninfoListener() 方 法 设置 警告 或 错误 信息 监听 器 ， 如 开始 缓冲 、 缓 冲 结束 和 下 载 速度 变化 等 。 


6) 准备 播放 器 : 通过 prepare() 方 法 准备 播放 器 。 








7) 开始 播放 : 通过 start() 方 法 开始 播放 。 














8) 设置 音量 大 小 : 通过 setVolume() 方 法 设置 音量 (范围 0.0~1.0 之 间 ， 此 处 为 0.5f) 。 




















9) 循环 等 待 播放 完成 。 





不 到 一 个 简单 的 播放 ， 预 先 设置 的 东西 这 么 多 1 ! |! 
PS pirer 哥 第 一 次 看 到 的 时 候 也 震惊 了 ! ! ! 


12.2.10 ”字幕 选择 /取消 选择 测试 














Android 提 供 的 MediaPlayer 播 放 器 目前 支持 播放 器 内 置 和 外 置 文 件 (.srt 文 件 ) 显示 字幕 ， 这 个 文件 可 以 通过 调用 getTrackinfo() 方 法 来 获得 所 有 的 追踪 器 。 





Trackinfo 共 有 4 种 类 型 ， 如 下 。 

1) 未 知 : public static final int MEDIA TRACK TYPE UNKNOWN=0。 
2) 视频 : public static final int MEDIA TRACK TYPE VIDEO-1, 

3) 音频 : public static final int MEDIA TRACK TYPE AUDIO-2, 


4) 字幕 : public static final int MEDIA TRACK TYPE TIMEDTEXT-3, 





对 于 字幕 信息 ，CTS 也 设计 了 一 系列 测试 ， 下 面 我 们 一 起 来 探 个 究竟 ! 














首先 是 “字幕 选择 /取消 选择 ”测试 ， 如 代码 清单 12-25 所 示 。 








代码 清单 12-25 ”字幕 选择 /取消 选择 测试 





public void testDeselectTrack() throws Exception ( 
// xuben: 导入 包含 2 个 字幕 的 视频 文件 
loadResource (R.raw.testvideo with 2 subtitles); 
// zuben: 再 单独 导入 1 个 字幕 文件 
loadSubtitleSource(R.raw.test subtitlel srt); 
// xuben: 通过 readTimedTextTracks () 获取 字幕 文件 ， 该 方法 稍 后 详 述 
readTimedTextTracks () ; 
// xuben: 此 时 获取 字幕 数 应 为 3 个 〈 即 2+1) ， 该 方法 稍 后 详 述 
assertEquals (getTimedTextTrackCount (), 3); 
// xuben: MIRGARARR GHG. BOW E. ARES) 
mMediaPlayer.setDisplay (getActivity () .getSurfaceHolder()); 
mMediaPlayer.setScreenOnWhilePlaying (true); 
mMediaPlayer.setWakeMode (mContext, PowerManager.PARTIAL WAKE LOCK); 
// xuben: 字幕 设置 监听 器 ， 若 此 时 有 字幕 ， 则 标记 mOnTimedTextCaIled ~ 
mMediaPlayer.setOnTimedTextListener (new MediaPlayer.OnTimedTextListener() ( 
GOverride 
public void onTimedText (MediaPlayer mp, TimedText text) ( 


if(text != null) ( 
String plainText = text.getText (); 
if(plainText != null) { 
mOnTimedTextCalled.signal (); 
Log.d(LOG_TAG, "text: " + plainText.trim()); 
} 
} 


} 

We 

// xuben: 开始 播放 

mMediaPlayer.prepare(); 

mMediaPlayer.start(); 

assertTrue (mMediaPlayer.isPlaying()); 

// xuben: 循环 测试 两 次 

for(int i = 0; i < 2; i++) { 
// xuben: 选择 内 置 字幕 1 ( 即 视频 文件 自 带 字幕 ) 进行 测试 ， 
// 该 方法 稍 后 详 述 
selectSubtitleTrack (0) ; 
// xuben: 此 时 播放 器 处 于 有 字幕 状态 
mOonTimedTextCalled.reset(); 
assertTrue (mOnTimedTextCalled.waitForSignal (1000)); 
// xuben: 取消 选择 内 置 字幕 1， 该 方法 稍 后 详 述 
deselectSubtitleTrack (0) ; 
// xuben: 此 时 播放 器 处 于 无 字幕 状态 
mOnTimedTextCalled.reset (); 
assertFalse (mOnTimedTextCalled.waitForSignal (1000)); 


l 
// xuben: 对 外 置 字幕 〈( 即 单独 导入 的 字幕 文件 ) 进行 测试 
for(int i = 0; i < 2; it+) { 
// xuben: 选择 外 置 字幕 进行 测试 
selectSubtitleTrack (2); 
// xuben: 此 时 播放 器 处 于 有 字幕 状态 
mOnTimedTextCalled.reset (); 
assertTrue (mOnTimedTextCalled.waitForSignal (1000) ); 
// xuben: 取消 选择 外 置 字幕 
deselectSubtitleTrack (2); 
// xuben: 此 时 播放 器 处 于 无 字幕 状态 
mOnTimedTextCalled. reset (); 
assertFalse (mOnTimedTextCalled.waitForSignal (1000) ); 
} 
try { 
// xuben: 取消 选择 未 选 字幕 ， 此 时 将 抛 异 常 
deselectSubtitleTrack (0) ; 
fail("Deselecting unselected track: expected RuntimeException, 
"but no exception has been triggered."); 
} catch (RuntimeException e) { 
// expected 


l 
// xuben: 停止 播放 器 
mMediaPlayer.stop(); 





遍历 播放 文件 中 的 字幕 文件 数 ， 如 代码 清单 12-26 所 示 。 


代码 清单 12-26 ”遍历 播放 文件 中 的 字幕 文件 数 





private void readTimedTextTracks() throws Exception { 
// xuben: 先 清空 字幕 文件 计数 器 mTimedTextTrackIndex 
mTimedTextTrackIndex.clear(); 
// xuben: i&itgetTrackInfo () 方法 获取 文件 信息 
MediaPlayer.TrackInfo[] trackInfos = mMediaPlayer.getTrackInfo(); 
if(trackInfos == null || trackInfos.length = 0) { 
return; 


l 
// xuben: 遍历 播放 文件 类 型 
for(int i = 0; i < trackInfos.length; ++i) { 
if (trackInfos[i] == null) continue; 
// xuben: 若 播放 文件 类 型 为 字幕 文件 ， 则 mTimedTextTrackIndex 加 1 
if(trackInfos[i].getTrackType() 一 
MediaPlayer.TrackInfo.MEDIA TRACK TYPE TIMEDTEXT) { 
mTimedTextTrackIndex.add (i); 
} 
} 
} 





获取 播放 文件 中 的 字幕 文件 数 ， 如 代码 清单 12-27 所 示 。 


代码 清单 12-27 ”获取 播放 文件 中 的 字幕 文件 数 





private int getTimedTextTrackCount() { 
// xuben: 通过 字幕 文件 计数 器 获取 当前 播放 文件 中 的 字幕 文件 数 
return mTimedTextTrackIndex.size(); 


} 





选择 外 置 字幕 ， 如 代码 清单 12-28 所 示 。 


代码 清单 12-28 ”取消 选择 外 置 字幕 





private void selectSubtitleTrack(int index) throws Exception { 
int trackIndex - mTimedTextTrackIndex.get (index); 
// xuben: 通过 selectTrack ) 方法 选择 字幕 ， 并 将 字幕 文件 索引 值 
// 赋 给 mSelecteqTimedTextIndex 
mMediaPlayer.selectTrack (trackIndex) ; 
mSelectedTimedTextIndex = index; 





取消 选择 外 置 字幕 ， 如 代码 清单 12-29 所 示 。 


代码 清单 12-29 ”删除 字幕 





private void deselectSubtitleTrack(int index) throws Exception ( 

int trackIndex - mTimedTextTrackIndex.get (index); 

// xuben: 通过 deselectTrack () 方法 取消 选择 字幕 ， 并 将 

// mSelectedTimedTextIndex 置 为 -1 

mMediaPlayer.deselectTrack (trackIndex); 

if (mSelectedTimedTextIndex == index) ( 
mSelectedTimedTextIndex - -1; 

} 

} 








芒 区 区 一 个 字幕 ， 还 分 内 置 外 置 的 测 半天 ， 有 点 浪费 表情 ! 


P 








字幕 选择 /取消 选择 测试 ， 如 图 12-12 所 示 。 








导入 包含 2 个 字幕 的 视频 文件 


-预先 设置 © 


单独 导入 1 个 字幕 文件 
视频 播放 基本 设置 ( 界面 、 屏 幕 常 亮 、 保 持 唤 醒 等 ) 


字幕 设置 监听 器 ， 若 此 时 有 字幕 ， 则 标记 mOnTimedTextCalled 


— — 开始 播放 





一 一 * 内 置 字幕 测试 





一 一 外 置 字幕 测试 | 


™ 





12-12 











12.2.11 


字幕 切换 测试 














既然 播放 器 字幕 可 选 ， 且 可 匹配 内 置 字幕 和 外 置 字幕 ， 那 字幕 切换 自然 不 成 问题 。 基 于 此 ， 





代码 清单 12-30 ”字幕 切换 测试 


选择 内 置 字幕 1 ( 即 视频 文件 自 带 字幕 ) 进行 测试 
了 | 此 时 播放 器 处 于 有 字幕 状态 


取消 选择 内 置 字幕 1， 此 时 播放 器 处 于 无 字幕 状态 


_ [选择 外 置 字幕 进行 测试 ， 此 时 播放 器 处 于 有 字幕 状态 
“取消 选择 外 置 字幕 ， 此 时 播放 器 处 于 无 字幕 状态 


一 一 取消 选择 未 选 字幕 ， 此 时 将 抛 噶 常 ， 


字幕 选择 /取消 选择 测试 














Tm 











要 对 场景 一 一 切换 字幕 ， 进 行 深入 测试 以 保 正确 ， 如 代码 清单 12-30 所 示 。 











public void testChangeSubtitleTrack() throws Exception { 
// xuben: 导入 包含 2 个 字幕 的 视频 文件 
loadResource (R.raw.testvideo_with_2 subtitles); 
// xuben: ii itreadTimedTextTracks () 确保 视频 文件 的 确 内 置 2 个 字幕 
readTimedTextTracks(); 
assertEquals (getTimedTextTrackCount(), 2); 
// xuben: 导入 2 个 外 置 字幕 文件 
loadSubtitleSource(R.raw.test subtitlel srt); 
loadSubtitleSource (R.raw.test subtitle2 srt); 
// xuben: iüitreadTimedTextTracks () 确保 播放 器 此 时 包含 4 个 字幕 
readTimedTextTracks(); 
assertEquals (getTimedTextTrackCount(), 4); 
// xuben: 视频 播放 基本 设置 (界面 、 屏 幕 常 亮 、 保 持 唤醒 等 ) 
mMediaPlayer.setDisplay (getActivity() .getSurfaceHolder()); 
mMediaPlayer.setScreenOnWhilePlaying (true); 
mMediaPlayer.setWakeMode (mContext, PowerManager.PARTIAL WAKE LOCK); 
// xuben: 字幕 设置 监听 器 ， 由 于 此 项 测试 关于 字幕 切换 ， 
// 所 以 字幕 监听 也 复杂 很 多 
mMediaPlayer.setOnTimedTextListener (new MediaPlayer.OnTimedTextListener () 
GOverride 
public void onTimedText (MediaPlayer mp, TimedText text) 
final int toleranceMs - 100; 
final int durationMs - 500; 
int posMs - mMediaPlayer.getCurrentPosition(); 
// xuben: 获取 字幕 
if(text != null) ( 
String plainText = text.getText (); 
if(plainText != null) { 
// xuben: 将 字幕 文件 以 冒号 (2) 分 隔 ， 以 便 获取 其 时 间 字 段 
StringTokenizer tokens new StringTokenizer (plainText.trim(), 
// xuben: 获取 字幕 文件 索引 
int subtitleTrackIndex = Integer.parseInt (tokens.nextToken()); 
// xuben: 获取 字幕 文件 开始 时 间 
int startMs Integer.parseInt (tokens.nextToken()); 
Log.d(LOG TAG, "text: " + plainText.trim() + 
", trackId: " + subtitleTrackIndex + ", posMs: " + posMs); 
// xuben: 测试 切换 字幕 是 否 超时 
assertTrue("The dif between subtitle's start time "+ startMs + 
" and current time " + posMs + 
is over tolerance " + toleranceMs, 
(posMs >= startMs - toleranceMs) && 
(posMs < startMs + durationMs + toleranceMs) 
// xuben: 测试 字幕 索引 是 否 正确 
assertEquals ("Expected track: " + mSelectedTimedTextIndex + 
", actual track: " + subtitleTrackIndex, 
mSelectedTimedTextIndex, subtitleTrackIndex) ; 
mOnTimedTextCalled.signal (); 
} 


{ 


{ 





) 7 


} 
1; 
// xuben: 准备 播放 器 ， 此 时 播放 器 尚未 运行 
mMediaPlayer.prepare(); 
assertFalse (mMediaPlayer.isPlaying()); 
// xuben: 设置 字幕 1， 并 重 置 索引 
selectSubtitleTrack (0) ; 
mOnTimedTextCalled. reset (); 
// xuben: 开始 运行 播放 器 ， 此 时 播放 器 应 顺利 运行 
mMediaPlayer.start(); 
assertTrue (mMediaPlayer.isPlaying()); 
// xuben: 至 少 等 待 2 个 字幕 切换 ， 超 时 为 2 秒 ， 测 试 文件 为 : 
// test_subtitlel_srt.3gpfetest_subtitle2_srt.3gp 
assertTrue (mOnTimedTextCalled.waitForCountedSignals (2, 2000) 
// xuben: 切换 为 字幕 2， 并 重 置 索引 
selectSubtitleTrack (1); 
mOnTimedTextCalled.reset(); 
assertTrue (mOnTimedTextCalled.waitForCountedSignals(2, 2000) >= 
// xuben: 切换 为 字幕 3， 并 重 置 索引 
selectSubtitleTrack (2); 





mOnTimedTextCalled.reset (); 

assertTrue (mOnTimedTextCalled.waitForCountedSignals (2, 2000) >= 2); 
// xuben: 切换 为 字幕 4， 并 重 置 索引 

selectSubtitleTrack (3); 

mOnTimedTextCalled.reset(); 

assertTrue (mOnTimedTextCalled.waitForCountedSignals (2, 2000) >= 2); 
// xuben: 停止 播放 器 

mMediaPlayer.stop(); 





全 看 来 我 还 说 早 了 ! 不 仅 内 置 外 置 测 半 天 ， 切 来 切 去 再 测 半 天 ……… 


字幕 切换 测试 ， 如 图 12-13 所 示 。 





导入 包含 2 个 字幕 的 视频 文件 
一 一 | 导入 2 个 外 置 字幕 文件 
预先 设置 “| 视频 播放 基本 设置 界面 、 屏 幕 党 高 、 保 持 唤醒 等 ) 
字幕 设置 监听 器 








设置 字幕 1， 并 重 置 索引 

开始 运行 播放 器 ， 此 时 播放 器 应 顺利 运行 
至 少 等 待 2 个 字幕 切换 ， 超 时 为 2 秒 
切换 为 字幕 2， 并重 置 索引 

切换 为 字幕 3， 并 重 置 索引 

切换 为 字幕 4， 并 重 置 索引 


图 12-13 ”字幕 切换 测试 


”具体 测试 < 


12.2.12 ”播放 器 回调 测试 


播放 器 包含 很 多 回调 函数 ， 为 确保 这 些 回 调 函数 都 能 正常 触发 ， 所 以 必须 安排 此 项 测试 ， 如 代码 清单 12-31 所 示 。 


代码 清单 12-31 ”播放 器 回调 测试 





public void testCallback() throws Throwable { 
final int mp4Duration = 8484; 
loadResource (R.raw.testvideo); 
mMediaPlayer.setDisplay (getActivity () .getSurfaceHolder()); 
mMediaPlayer.setScreenOnWhilePlaying (true); 
// xuben: 设置 播放 器 界面 大 小 设置 监听 器 
mMediaPlayer.setOnVideoSizeChangedListener (new 
MediaPlayer.OnVideoSizeChangedListener() ( 
GOverride 
public void onVideoSizeChanged(MediaPlayer mp, int width, int height) ( 
mOnVideoSizeChangedCalled.signal (); 
} 


1; 
// xuben: 设置 播放 器 准备 就 绪 监 听 器 
mMediaPlayer.setOnPreparedListener (new MediaPlayer.OnPreparedListener() ( 
GOverride 
public void onPrepared (MediaPlayer mp) ( 
mOnPrepareCalled.signal (); 
} 


1); 

// xuben: 设置 播放 器 播放 跳 转 监听 器 

mMediaPlayer.setOnSeekCompleteListener (new 

MediaPlayer.OnSeekCompleteListener() { 
GOverride 
public void onSeekComplete (MediaPlayer mp) ( 
mOnSeekCompleteCalled.signal(); 
} 


We 
// xuben: 设置 播放 器 播放 结束 监听 器 
mOnCompletionCalled.reset(); 
mMediaPlayer.setOnCompletionListener (new MediaPlayer.OnCompletionListener () 
{ 
GOverride 
public void onCompletion (MediaPlayer mp) { 
mOnCompletionCalled.signal (); 
} 
1; 
// xuben: 设置 播放 器 播放 异常 监听 器 
mMediaPlayer.setOnErrorListener (new MediaPlayer.OnErrorListener() { 
GOverride 
public boolean onError(MediaPlayer mp, int what, int extra) ( 
mOnErrorCalled.signal (); 
return false; 
} 
1); 
// xuben: 设置 播放 器 警告 或 错误 信息 监听 器 ， 
// do: 开始 缓冲 、 缓 冲 结束 、 下 载 速度 变化 等 
mMediaPlayer.setOnInfoListener (new MediaPlayer.OnInfoListener() { 
GOverride 
public boolean onInfo(MediaPlayer mp, int what, int extra) ( 
mOnInfoCalled.signal (); 
return false; 
} 


1; 

// xuben: 此 时 ， 播 放 器 准备 就 结 回调 函数 尚未 被 调用 
assertFalse (mOnPrepareCalled.isSignalled()); 

// xuben: 此 时 ， 播 放 器 界面 大 小 设置 回调 函数 尚未 被 调用 
assertFalse (mOnVideoSizeChangedCalled.isSignalled()); 
// xuben: 播放 器 准备 ， 此 时 准备 就 绪 、 大 小 设置 回调 函数 被 调用 
mMediaPlayer.prepare(); 
mOnPrepareCalled.waitForSignal(); 
mOnVideoSizeChangedCalled.waitForSignal (); 

// zuben: 播放 器 跳 转 ， 此 时 跳 转 回调 函数 被 调用 ， 

// 而 因为 此 时 音乐 仍 在 播放 ， 所 以 播放 完成 回调 函数 仍 未 被 调用 
mOnSeekCompleteCalled. reset (); 





mMediaPlayer.seekTo (mp4Duration >> 1); 
mOnSeekCompleteCalled.waitForSignal (); 
assertFalse (mOnCompletionCalled.isSignalled()); 
// xuben: 开始 播放 并 循环 至 播放 完成 ， 此 时 播放 完成 回调 函数 被 调用 
mMediaPlayer.start(); 
while (mMediaPlayer.isPlaying()) { 

Thread.sleep(SLEEP TIME); 


} 

assertFalse (mMediaPlayer.isPlaying()); 
mOnCompletionCalled.waitForSignal (); 

// xuben: 正常 情况 下 ， 播 放 异 常 回调 函数 不 会 被 调用 
assertFalse (mOnErrorCalled.isSignalled()); 

// xuben: 播放 停止 后 再 直接 开始 播放 ， 播 放 异 常 函数 被 调用 
mMediaPlayer.stop(); 

mMediaPlayer.start(); 
mOnErrorCalled.waitForSignal () ; 





Se 
Sek, PSS BTS HAR Be! ! ! 


播放 器 回调 测试 ， 如 图 12-14 所 示 。 





/设置 播放 器 界面 大 小 设置 监听 器 
设置 播放 器 准备 就 绪 监听 器 
设置 播放 器 播放 跳 转 监听 器 
设置 播放 器 播放 结束 监听 器 
设置 播放 器 播放 异常 监听 器 
-设置 播放 器 警告 或 错误 信息 监听 器 


。 监听 器 设置 = 







播放 器 准备 就 绪 回调 函数 尚未 被 调用 
| jessie aperui era icis 
-* MERE O 播放 器 准备 ， 此 时 准备 就 绪 、 大 小 设置 回调 函数 被 调用 


播放 器 跳 转 ， 此 时 跳 转 回调 函数 被 调用 ， 
而 因为 此 时 音乐 扔 在 播放 ， 所 以 播放 完成 回调 函数 仍 未 被 调用 


—e 开始 播放 并 循环 至 播放 完成 'S 此 时 播放 完成 回调 浮 数 被 调用 


[正常 情况 下 ， 播 放 异常 回调 函数 不 会 被 调用 
播放 停止 后 再 直接 开始 播放 ， 播 放 异 常 函数 被 调用 


图 12-14 ”播放 器 回调 测试 


-。 播放 异常 检查 © 


12.2.43 ”视频 录制 播放 测试 


播放 器 播放 文件 有 很 多 种 方式 ， 比 如 设置 文件 绝对 路 径 进行 播放 、 设 置 文件 URI 进 行 播放 、 创 建 播放 器 时 直接 传 入 文件 URI 进 行 播放 等 ， 所 以 安排 此 项 测试 ， 如 代码 清单 12-32 所 示 。 


代码 清单 12-32 ”视频 录制 播放 测试 





public void testRecordAndPlay() throws Exception { 
// xuben: 检测 系统 是 否 包 含 麦克 风 组 件 ， 若 无 该 组 件 ， 此 测试 无 效 
if(!hasMicrophone()) { 
return; 


l 
// xuben: 设置 播放 文件 格式 及 路 径 
File outputFile = new File (Environment.getExternalStorageDirectory(), 
"record and play.3gp"); 
String outputFileLocation = outputFile.getAbsolutePath(); 
try { 
// xuben: 录制 视频 
recordMedia (outputFileLocation); 
MediaPlayer mp - new MediaPlayer(); 
try ( 
// xuben: 为 播放 器 设置 文件 绝对 路 径 ， 通 过 绝对 路 径 进行 播放 和 停止 
mp.setDataSource (outputFileLocation); 
mp.prepareAsync () ; 
Thread. sleep (SLEEP_TIME) ; 
playAndStop (mp); 
) finally ( 
mp.release(); 


l 

// xuben: 将 文件 绝对 路 径 转 为 URI 形 式 

Uri uri = Uri.parse (outputFileLocation) ; 
mp = new MediaPlayer(); 


try { 
// xuben: 为 播放 器 设置 文件 URI， 通 过 URI 进 行 播放 和 停止 
mp.setDataSource (mContext, uri); 
mp.prepareAsync (); 
Thread.sleep(SLEEP TIME); 
playAndStop (mp) ; 
} finally { 
mp.release(); 
} 
try { 
// xuben: 在 创建 播放 器 时 直接 传 入 文件 URI， 通 过 URI 进 行 播放 和 停止 
mp = MediaPlayer.create (mContext, uri); 
playAndStop (mp); 
) finally ( 
if(mp != null) ( 
mp.release(); 
} 
} 
try { 


// xuben: 在 创建 播放 器 时 除了 传 入 文件 URI 外 ， 还 传 入 界面 参数 
mp = MediaPlayer.create (mContext, uri, getActivity() .getSurfaceHolder()); 
playAndStop (mp) ; 
} finally { 
if(mp != null) { 
mp.release(); 
} 


} 
} finally { 
outputFile.delete(); 





播放 停止 方法 很 简单 ， 就 是 在 播放 和 停止 之 间 加 一 个 等 待 时间 ， 如 代码 清单 12-33 所 示 。 


代码 清单 12-33 ”播放 停止 





private void playAndStop (MediaPlayer mp) throws Exception { 
mp.start(); 
Thread.sleep(SLEEP TIME); 
mp.stop(); 

} 





视频 录制 方法 如 代码 清单 12-34 所 示 。 


代码 清单 12-34 ”视频 录制 





private void recordMedia(String outputFile) throws Exception { 
MediaRecorder mr = new MediaRecorder(); 


try { 
// xuben: 录制 基本 设置 : 格式 、 编 码 、 输 出 

mr.setAudioSource (MediaRecorder.AudioSource.MIC); 

mr.setOutputFormat (MediaRecorder.OutputFormat.THREE GPP); 

mr.setAudioEncoder (MediaRecorder.AudioEncoder.AMR NB); 

mr.setOutputFile (outputFile) ; 

// xuben: 启动 及 停止 录制 

mr.prepare(); 

mr.start(); 

Thread.sleep(SLEEP TIME); 

mr.stop(); 

finally ( 

mr.release(); 





检查 麦克 风 如 代码 清单 12-35 所 示 。 


代码 清单 12-35 ”检查 麦克 风 





private boolean hasMicrophone() { 
// xuben: 检查 设备 是 否 具有 麦克 风 功 能 模块 
return getActivity() .getPackageManager () .hasSystemFeature ( 
PackageManager.FEATURE MICROPHONE); 
} 





M 
全 哈哈 ， 一 孙 一 播 ， 一 生 就 这 样 过 去 了 …，… 


视频 录制 播放 测试 如 图 12-15 所 示 。 





4 资源 检查 “| 检测 系统 是 否 包含 麦克 风 组 件 ， 若 无 该 组 件 ， 此 测试 无效 


- 预先 设置 c 设置 播放 文件 格式 及 路 径 


录制 视频 
为 播放 器 设置 文件 绝对 路 径 ， 通 过 绝对 路 径 进行 播放 和 停止 

具体 测试 “5. 将 文件 绝对 路 径 转 为 URI 形 式 

一 在 创建 播放 器 时 直接 传 入 文件 URI , 通过 URI 进 行 播放 和 停止 
在 创建 播放 器 时 除了 传 入 文件 URI 外 ， 还 传 入 界面 参数 


图 12-15 ”视频 录制 播放 测试 


123 ”CTS 的 原理 总 结 


99... ., 有 什么 感受 ? 

" 

全 5 感觉 好 详细 ， 我 肯定 想不到 这 么 多 1 

$9, us, 就 其 测试 技术 而 言 ， 必 须要 进行 边界 值 、 等 价 类 等 设计 ， 而 无 论 是 边界 值 还 是 等 价 类 ， 都 包含 了 大 量 测试 用 例 一 对 于 黑金 测试 如 此 ， 对 于 单元 测试 亦 是 如 此 。 
5 el f 

SARERA RRA HSH, RN RAMEE B RAY MOL 


eO, us 了 一 个 很 常见 的 借口 。 很 多 测试 员 因为 编程 水 平 的 限制 ， 把 单元 测试 、 自 动 化 测试 等 需要 写 代码 的 测试 看 得 非常 神秘 。 


QO 5 esito eon, 看 不 起 基本 的 测试 技术 〈 如 上 所 言 的 边界 值 、 等 价 类 ， 还 有 诸如 决策 表 、 因 果 图 和 状态 机 等 ) 。 


e» 


< 全 人 额 ， 好 像 有 些 道理 。 


(> CEP 优秀 的 测试 员 首先 需要 具备 的 就 是 扎实 的 测试 技术 功底 。 


只 有 掌握 了 最 基本 的 测试 技术 后 ， 无 论 做 什么 测试 (黑金 、 白 使 、 自 动 化 、 性 能 或 是 单元 测试 ) ， 都 能 游刃有余 ， 设 计 的 测试 用 例 也 才能 真正 深入 ， 进 而 发 现 隐藏 的 pug。 


| CPEMFTPPPP 哪怕 编程 能 力 再 好 ， 设 计 的 用 例 也 漏洞 百出 ， 发 现 不 了 问题 的 根源 。 





全 < 严重 同意 ! 


99, “不 同 格式 视频 文件 测试 ”为 例 。 


如 果 要 确保 测试 到 位 ， 就 一 定 要 设计 各 种 不 同 格式 的 播放 文件 〈 类 型 、 编 码 格 式 、 分 状 率 、 比 特 率 、 帧 率 、 音 频 格式 、 声 道 和 频率 等 ) ， 所 以 有 此 测试 。 
fe 
人 是 啊 ， 这 个 测试 覆盖 得 好 全 面 ! 


9o 大 家 不 难看 出 ， 设 计 这 个 用 例 的 单元 测试 工程 师 是 多 么 的 不 厌 其 烦 ， 一 点 点 地 从 细节 上 去 把 控 。 


而 很 多 同学 却 认为 这 些 琐碎 的 小 事情 不 值得 花 时 间或 认为 没有 技术 含量 ， 而 只 是 草草 写 上 几 个 ， 相 比 Google 的 大 牛 们 ， 难 道 不 汗颜 吗 ? 


e... 你 再 说 下 去 ， 他 们 岂止 是 汗颜 ， 简 直 就 要 湿 透 了 ! 


第 13 章 ” Android 自动 化 工具 源码 总 结 





驴 读 完 源码 ， 学 学 的 ， 自 我 感 党 high 翻 天 ， 就 像 喝 了 鸡尾酒 ! 


E 
人 哈哈， 咱们 终于 从 代码 的 海洋 中 游 出 来 了 ! 我 爱 阳 光 ， 我 爱 空气 ， 我 爱 淡水 …… 


se， 感慨 了 ， 说 说 你 的 感受 吧 ! 





3 最 大 的 感受 就 是 ， 累 并 快乐 着 ， 感 觉 自 己 像 个 刚 出 生 的 孩子 ， 满 怀 好 奇 地 打量 着 这 个 新 奇 的 世界 。 
9o... 那 你 在 这 个 新 奇 的 世界 中 学 到 了 什么 呢 ? 

Se 

人 当时 觉得 好 多 好 多 ， 感 觉 都 吃 述 了 ， 现 在 回头 想 想 又 什么 都 想 不 起 了 1! 

eo... 那 咱们 一 起 来 想 想 ， 首 先是 monkey， 能 想起 什么 ? 

Se 

< 从 就 能 想起 咱们 是 从 main(0) 方 法 进入 ， 从 ran0 方 法 启程 ， 其 他 都 想 不 起 了 。 

eo, 亲 ， 你 确定 脑袋 里 不 是 豆腐 渣 ? 


Sir, AMDA? 





9o. 我 来 说 : 通过 牢 牢 把 握 run() 方 法 这 条 线索 ， 咱 们 看 到 了 monkey 是 如 何 细 分 参数 ， 如 何 导 入 package 列 表 ， 如 何 循环 取 事 件 ， 如 何 组 建 事件 队列 ， 如 何 将 事件 注入 系统 ， 实 现 对 系统 的 控制 的 。 


€ 
TUR, HKmonkey Ht xp KAA 9 27/6 270 SET Ab BE 85 SERES 





RO pn 简化 得 可 以 ! 而 monkeyrunner 命 令 则 分 为 通过 “父亲 ”发 命令 和 通过 “母亲 ”发 命令 ， 还 记得 吗 ? 

Se 

< 人 哈哈， 想起 来 了 ， 通 过 “父亲 ”发 命令 ， 就 是 通过 monkeyrunnet 的 “父亲 ”monkey 来 发 命令 ， 比 如 press、type、touch 和 drag 等 常用 操作 类 命令 均 来 自 monkey。 

e. ， 通 过 “母亲 ”发 命令 ， 就 是 通过 adb 服 务 器 与 目标 设备 的 adb 守 护 进 程 进 行 通信 ， 比 如 installPackage、startActivity、takeSnapshot 和 teboot 等 方法 均 是 通过 adb 进 行 发 送 的 。 
< 哈哈 ， 看 来 我 记性 没 那么 差 ! 下 面 我 再 来 说 说 Instrumentation 注 入 事件 的 过 程 ! 

qo... 不 错 啊 ， 进 入 状态 了 ? 


SORA! 别 干扰 我 ! 首先 ， 通过 WindowManaget 的 addView0 方 法 将 主 窗 口中 的 DecorView 添 加 到 WindowManager 中 ， 并 建立 会 话 。 


全 其 次 ， 通 过 WindowManaget 的 updateViewLayout0 方 法 来 刷新 窗口 。 


最 后 ， 通 过 WindowManager 的 removeView( 方法 来 移 除 窗口 。 
eo... 不 错 ， 而 UIAutomator 则 是 通过 UiAutomatorBridge 获 取 界 面 或 进行 事件 注入 ， 进 而 获取 控件 根 节 点 ， 遍 历 整 棵 控件 树 ， 获 取 控 件 边 界 以 便 进 行 更 进一步 的 操作 。 


s» 
全 改 赖 皮 ， 还 跟 我 抢 着 说 ， 不 过 你 忘 了 UIAutomator 还 可 以 进行 事件 发 送 。 


eo... 补充 得 好 ! CTS 是 你 的 最 爱 ， 那 你 继续 说 吧 ! 


ie 
合唱 ，CTS 的 测试 用 例 读 下 来 ， 感 觉 是 最 顺畅 的 ， 也 是 最 清晰 的 。 


学 习 CTS 测 试用 例 的 过 程 ， 其 实 也 是 一 个 自我 修炼 的 过 程 。 


b 
全 %% 从 CTS 用 例 里 看 到 很 多 自己 设计 测试 用 例 的 不 足 ， 这 个 不 足 不 仅 体现 在 单元 测试 用 例 设 计 上 ， 还 体现 在 黑金 测试 用 例 上 ， 从 此 我 再 也 不 敢 轻 视 用 例 设 计 了 。 


(c 
ht C) Rint aR SM, 不 过 我 仍然 没 看 到 任何 的 产 出 。 


全 又 来 了 ， 真 受 不 了 这 个 败 兴 的 白 富美 ! 


eo... BOSS 放 心 ， 磨 刀 不 误 砍 柴 工 ， 让 你 意 想 不 到 的 产 出 即将 到 来 ! 


第 三 部 分 “实践 篇 


“第 14 章 ”从 monkey 到 传 参 或 录制 工具 开发 

- 第 15 章 ”从 Instrumentation 到 稳定 自动 化 工具 开发 

- 第 16 章 ”从 UIAutomatorViewer 到 PC 端 脚 本 录制 工具 开发 
“第 17 章 ”从 CTS 到 定制 化 单元 测试 

“ 第 18 章 Android 自动 化 实践 之 路 514 


这 一 部 分 我 们 将 开启 Android 自 动 化 实践 之 旅 
eo, uon 咱们 通过 实践 来 检验 真理 吧 ! 


SPAKE, LATHAM, AF, BATA? 


Wss, 路 在 脚下 ! 说 起 自动 化 实践 ， 我 们 先 得 从 Android 的 层级 角度 分 析 一 下 官方 主流 的 自动 化 工具 和 框架 ! 


从 Android 各 层 的 角度 分 析 官 方 主流 的 自动 化 工具 和 框架 ， 如 图 所 示 。 


| monkey 
| Application > monkeyrunner 
— -= -UlAutomator 





a y Instrumentation 
E 1 


F ` 
! 
Li 
/ 
t 
+ 


pp um 0 9 


Libraries = ° 





Kernel 


ie 
Meek, We TELS, HOSDURÉT EAR! 


9 Jas, 学 然后 知 不 足 。 基 于 此 ， 当 时 巴 哥 奔 海盗 船 的 兄弟 姐妹 们 一 起 努力 ， 做 了 如 下 补充 。 


对 Android 各 层级 工具 补充 ， 如 图 所 示 。 


monkey 
Application monkeyrunner 
UIAutomator 





Instrumentation 
^ Framework ‘SCTS 


+ 接口 功能 测试 工具 集 








Libraries © *HALE T EE 


Kernel © +Driver 层 测试 工具 集 


人 哈哈， 这 下 看 上 去 比较 全 面 了 ! 


È PT 当时 大 家 费 了 大 力气 ， 为 此 巴 哥 奔 还 专门 申请 过 一 个 专利 加 以 保护 ， 如 下 所 示 。 
一 种 智能 手机 及 其 故障 检测 方法 (专利 申请 号 : CN103458086A) 


本 发 明 实施 例 提供 一 种 智能 手机 及 其 故障 检测 方法 ， 涉 及 通信 领域 ， 能 够 对 智能 手机 异常 情况 进行 定位 。 所 述 智 能 手机 的 故障 检测 方法 包括 : 接收 故障 检测 指令 ; 对 所 述 手 机 操作 系统 的 应 用 层 和 /或 中 
间 层 和 /或 驱动 层 进行 故障 检测 ; 记录 故障 检测 结果 ， 所 述 故 障 检 测 果 中 包括 所 述 智 能 手机 的 应 用 层 和 /或 中 间 层 和 /或 驱动 层 的 异常 情况 。 


本 发 明 实 施 例 提供 的 智能 手机 及 其 故障 检测 方法 用 于 智能 手机 的 使 用 。 
Be., 不 错 啊 ， 还 懂得 将 咱们 公司 的 知识 产权 加 以 保护 ， 鼓 励 一 下 ! 
Be. 看 上 去 很 高 大 上 的 样子 ! 不 过 没 看 懂 ! 

9o... 那 我 简单 解释 一 下 这 个 专利 。 


一 种 智能 手机 及 其 故障 检测 方法 ， 简 单 解释 如 图 所 示 。 


随 着 Android 手 机 应 用 日 趋 广泛 ， 
- ”针对 Android 平 台 的 手机 卫士 也 越 来 越 多 ， 
背景 O 但 大 多 数 是 用 于 手机 病毒 防护 或 手机 垃圾 处 理 。 
如 果 应 用 程序 出 现 问 题 ， 或 者 系统 挂 掉 ， 
只 能 找 专业 人 员 进 行 处 理 ， 用 户 很 难 定位 问题 或 进行 修复 


1. 通 过 一 整套 测试 程序 构成 完善 的 手机 检测 工具 , 

分 别 从 Kernel 层 ，HAL 层 ，Framework 层 ，Application 层 
方案 © 等 所 有 常用 接口 进行 整体 测试 ， 迅 速 列 出 所 有 异常 接口 

2. 通 过 对 底层 log ( 如 dmsg,bugreport 等 ) 

的 自动 分 析 ， 快 速 定 位 错误 情况 





通过 一 套 工具 集 ， 分别 从 Kernel 层 ，HAL 层 ，Framework 层 , 
Application 层 进行 测试 ， 只 需 在 界面 上 点 击 测试 ， 各 层 分 别 
—— 开始 测试 ，Application 层 通过 获取 控件 ID 运行 用 例 ，Framework 层 
说 明 O 通过 API 接 口 进行 测试 ，HAL 层 通过 HAL 层 接口 测试 ，Kernel 层 
通过 读 取 节 点 值 等 方式 运行 ， 贯 穿 一 起 ， 并 统一 给 出 测试 结果 


另 一 方面 ， 通 过 对 底层 log ( 如 dmsg,bugreport 等 ) 的 自动 分 析 , 
不 断 更 新 经 验 库 ， 对 常见 错误 进行 快速 定位 


SAAT! 那 咱们 就 按照 这 个 思路 进行 开发 ? 感觉 哪里 不 对 ? 


eo. 咱们 这 本 书 主要 针对 自动 化 ， 自 然 不 需要 对 HAL 层 或 Kernel 层 进行 测试 了 。 
全 难怪， 我 说 好 多 没 学 过 呢 ! 看 来 自动 化 的 不 足 还 变 多 的 ! 

! CT 自动 化 本 身 就 是 针对 上 层 界面 设计 的 。 上 层 测试 与 底层 测试 各 有 各 的 逻辑 和 针对 性 。 
全 既然 只 针对 上 层 ， 那 咱们 该 从 何 处 入 手 呢 ? 

PS nes 紧 紧 围绕 着 项 目的 实际 需求 ， 有 的 放 夭 地 进行 自动 化 的 工具 开发 或 框架 的 二 次 封装 。 

| CT" 赶紧 开 练 吧 ! 


LÀ 
人 好， 那 就 让 咱们 看 看 BOSS 又 有 哪些 变态 的 需求 吧 ! 


第 14 章 ”从 monkey 到 传 参 或 录制 工具 开发 


LEE 开发 顺手 小 工具 的 乐趣 吧 ! 


14.1 从 monkey 原 理 说 开 来 


全 % 额 ， 这 么 多 工具 还 不 满足 ? 

OO " - " x 

“当然 不 够 ， 比 如 说 monkey， 那 么 多 参数 ， 又 是 命令 行 输入 ， 大 家 很 容易 输入 错误 。 

TU AG, End? 

[= 为 大 家 做 个 可 视 化 的 界面 ， 直 接 在 界面 选择 运行 就 不 容易 出 错 了 。 

eo, 外 ，monkey 不 支持 录制 …… 

SLA REAR TS? 用 monkeyrunnet* 阿 ! 

| res 大 家 都 不 爱 用 。 而 且 录 制 的 脚本 研发 部 门 也 不 认可 ， 说 不 方便 定位 问题 。 


pA 
SARA, WAIT S 


na, 所 以 说 ， 梦 想 很 性 感 ， 现 实 很 骨 感 ， 既 然 大 家 这 么 需要 monkey 亲 自 录 制 ， 那 咱们 不 妨 做 一 款 。 


5 好 吧 ， 有 你 带 着 ， 我 也 不 怕 啦 ， 那 咱们 先 从 传 参 小 工具 开始 吧 1 
14.2 monkey 传 参 小 工具 


本 书 2.4 节 中 对 monkey 各 类 命令 进行 了 总 结 ， 但 绝 大 多 数 测试 员 都 不 会 命令 行 运行 或 调试 ， 这 么 多 命令 也 很 难 记 住 ， 该 如 何 设计 一 款 能 让 大 家 轻松 运行 monkey 的 可 视 化 小 工具 呢 ? 如 何 巧 妙 地 将 
monkey 命 令 参数 与 功能 选项 相 匹 配 ? 





下 面 让 我 们 开启 monkey 传 参 小 工具 的 设计 之 旅 吧 ! 


14.2.1 monkey 传 参 小 工具 之 常规 类 命令 


RASH, BAM DAB? 


2°... 咱们 就 按 之 前 学 习 的 顺序 ， 逐 个 命令 进行 分 析 吧 ! 





首先 来 看 看 monkey 常 规 类 命令 ， 如 图 14-1 所 示 。 




















一 一 一 -h: monkey 参 数 帮 助 信息 — 


0 级 ， 除 启动 提示 、 测 试 完成 
和 最 终结 果 外 提供 较 少 
,1 级 ， 提 供 较 详细 测试 信息 ， 
如 逐个 发 送 到 Activity 
2 级 ， 提 供 更 详细 安装 信息 ， 
如 测试 中 被 选中 或 未 被 选中 的 Activity 


14-1 monkey 常 规 类 命令 


~ vi 打印 出 日 志 信息 - 














monkey 常 规 类 命令 设计 界面 ， 如 图 14-2 所 示 。 





下 面 简要 介绍 一 下 monkey 常 规 类 命令 基本 功能 。 
1) 日 志 级 别 : 传 入 -v 参 数 打印 日 志 信息 。 

- 基本 Log: 对 应 0 级 日 志 信息 。 

- 详细 Log: 对 应 1 级 日 志 信息 。 


. 全 部 Log: 对 应 2 级 日 志 信 息 。 





2) 帮助 文档 : 传 入 -h 参 数 弹出 monkey 帮 助 信息 (这 里 弹出 参数 信息 用 处 不 大 ， 建 议 弹出 工具 的 帮助 信息 ) 。 


基本 Log\@ ) 详细 Log\ /全 部 Log E. ux 681 


: 8, GAHE! 


帮助 文档 
上 什么 功能 都 没有 。 





14-2 ”monkey 常规 类 命令 设计 界面 














e 
95... 心急 吃 不 了 热 豆腐 ， 慢 慢 来 ， 咱 们 先 来 看 看 目前 都 有 哪些 功能 。 


不 难看 出 ， 常 规 类 命令 还 没 真正 涉及 monkey 运 行 ， 只 是 对 monkey 工 具 进 行 了 最 基础 的 准备 工作 。 





14.2.2 monkey 传 参 小 工具 之 事件 类 命令 





接 下 来 ， 让 我 们 看 看 事件 类 命令 ， 如 图 14-3 所 示 。 


-* -于 :测试 脚本 名 运行 


/ 。 -s : 随机 运行 


事件 百分比 

















monkey 事 件 类 命令 设计 界面 ， 如 图 14-4 所 示 。 





Monkey 测 试 : 
志 级 别 : 


基本 Log 


详细 Log 全 部 Log 


指令 间隔 : 


引 令 间 固 定 间隔 时 间 

















。 --throttle : 指令 间 固 定时 间 间 隔 


--ptc-touch : 触摸 事件 百分比 
--ptc-motion : 动作 事件 百分比 
--ptc-trackball : 轨迹 球 事件 百分比 
--ptc-nav : 基本 导航 事件 百分比 


_[--ptc-majornav : 主要 导航 事件 百分比 
--ptc-syskeys : 系统 按键 事件 百分比 


--ptc-appswitch : 应 用 启动 事件 百分比 
keypress 


--ptc-anyevent: “不 常用 的 button 
其 他 类 型 事件 百分比 其 他 未 提 及 事件 


14-3 monkey 事件 类 命令 


(i 哇 ， 增 加 事件 类 命 


| 令 后 ,功能 一 下 增 
让 ”加 了 不 少 ,哈哈 ! S 


^ " -— 
M TEL. ^ f 
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14-4 monkey 事 件 类 命令 设计 界面 


$9... 这 里 ， 传 入 monkey 脚 本 地 址 和 随机 运行 、 指 令 间 隔 几 项 ， 都 是 我 的 最 爱 。 
下 面 ,介绍 monkey 事 件 类 命令 新 增 功能 。 

1) monkey 脚 本 地 址 : 传 入 -f 并 通过 浏览 导入 需要 运行 的 monkey 脚 本 。 

2) 随机 运行 : 传 入 -s 参 数 并 输入 随机 运行 次 数 。 


3) 指令 间隔 : 传 入 --throttle 参 数 并 输入 指令 间 固 定 间隔 时 间 。 











4) 事件 百分比 设置 : 进行 各 类 事件 百分比 的 设置 ， 点 击 后 的 界面 如 图 





14-5 所 示 。 


bugben 


~ 事件 百分比 
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触摸 事件 je UN 

动作 事件 想不到 时 间 百 分 比 
i ut ` 

轨迹 球 事件 : UE To EAA 
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图 14-5 各 类 事件 百分比 的 设置 





界面 跳 转 到 一 个 可 展开 的 事件 设置 列表 中 ， 点 击 即 可 对 某 个 对 














A 


件 进行 设置 ， 如 图 14-6 所 示 。 


和 触 损 事件 自分 比 





























图 14-6 ”事件 百分比 设置 





当然 ， 这 种 设计 只 是 巴 哥 奔 的 个 人 喜好 ， 大 家 可 以 根据 自身 喜好 和 项 目 需求 进行 更 为 高 效 的 界面 设计 。 








引入 事件 类 命令 选项 后 ， 小 工具 的 基本 雏形 已 经 具备 ， 尤 其 























是 monkey 脚 本 的 传 入 ， 使 得 工 











可 以 运行 非常 复杂 的 monkey 测 试 。 
142.3 ”monkey 传 参 小 工具 之 约束 类 命令 





再 下 来 ， 让 我 们 看 看 约束 类 命令 ， 如 图 14-7 所 示 。 





* -p: 测试 一 个 或 多 个 包 


© -c : 测试 一 个 或 多 个 类 别 











14-7 monkey 约 束 类 命令 











monkey 约 束 类 命令 设计 界面 ， 如 图 14-8 所 示 。 

















测试 : 
日 志 级 别 : 


基本 Log 详细 Log 全 部 Log 


指令 间隔 : a 
y OE. 又 多 E 网 aii ^ 


随机 运行 次 数 指令 间 固 定 间隔 时 间 ` 
»- 62638! y / 
测试 指定 包 : 测试 指定 类 : : Lu 
请 输入 测试 包 名 | 请 输入 测试 类 名 "E M ferret 
à, 4 ^ TENE 
事件 百分比 设置 N -» 
L 3 


` , 
cr 
帮助 文档 2 














414-8 ”monkey 约 束 类 命令 设计 界面 





9o... 这 样 一 来， 就 可 以 指定 测试 巴 哥 奔 应 用 了 1! 





下 面 介 绍 monkey 约 束 类 命令 新 增 功能 。 
1) 测试 指定 包 : 传 入 -p 并 输入 需要 monkey 测 试 的 包 名 ， 如 com.xuben .test.settings。 


2) 随机 指定 类 : 传 入 -c 参 数 并 输入 需要 monkey 测 试 的 类 名 ， 如 Intent.CATEGORY_LAUNCHER。 























到 这 里 ，monkey 小 工 


已 经 基本 成 型 。 值 得 一 提 的 是 ， 巴 哥 奔 这 里 的 设计 是 针对 专业 的 测试 员 ， 他 们 清楚 自己 希望 测试 哪个 包 或 哪个 类 ， 也 清楚 相应 的 包 名 和 类 名 。 但 对 了 
设计 为 一 个 应 用 允 


I 表 ， 用 户 只 需 义 选 一 个 或 多 个 应 用 即 可 直接 对 其 进行 测试 (无 需 输入 ) ， 供 大 家 参考 。 
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14.2.4 ” monkey 传 参 小 工具 之 调试 类 命令 





最 后 ， 让 我 们 看 看 调试 类 命令 ， 如 图 14-9 所 示 。 























* --dbg-no-events : 监视 应 用 程序 所 调用 的 包 之 间 的 转换 


一 * --hprof : 在 事件 序列 前 后 立即 生成 profiling report 


--ignore-crashes : 
在 应 用 程序 崩溃 后 继续 发 送 事 件 
| i- ~“ignore-timeouts : 
出 请 后 继续 发 送 事件 ”在 任何 超时 错误 发 生 后 继续 发 送 事件 
--ignore-security-exceptions : 


在 应 用 程序 权限 错误 发 生 后 继续 发 送 事件 


--kill-process-after-error : 


在 应 用 程序 出 错 后 通知 系统 停止 发 生 错 误 的 进程 





--monitor-native-crashes : 


监视 并 报告 monkey 运 行 时 Android 系 统 native code 的 崩溃 事件 





“一 。 --wait-dbg : 暂停 执行 中 的 monkey ， 直 到 有 调试 器 与 它 连 接 








14-9 ” monkey 调试 类 命令 








Oaar, 这 里 只 是 举例 ， 大 家 可 以 酌情 添加 项 目 所 需 功 能 ! 


monkey 调 试 类 命令 设计 界面 ， 如 图 14-10 所 示 。 





下 面 介绍 monkey 调 试 类 命令 新 增 功能 。 





1) 出 错 后 继续 运行 : 传 入 “-ignore” 开 头 的 3 个 参数 (如 果 挨 个 区 分 不 是 不 行 ， 但 界面 将 显得 非常 见 余 ， 事 实 上 ， 巴 哥 奔 此 处 设计 的 界面 已 经 比 实 际 项 目 需要 多 了 很 多 宛 余 的 功能 ， 大 家 可 以 根据 项 目 
需要 进行 增删 ) 。 


2) 生成 profilfing report: 传 入 --hprof 参 数 在 事件 序列 后 获取 profilfing report, 


bugben 
Monkey3llixt : 


日 志 级 别 : 
基本 Log 


详细 Log 全 部 Log 


生成 profiling report 


出 错 后 继续 运行 


指令 间隔 : 


随机 运行 次 数 间 令 间 固 定 间 隔 时 间 


测试 指定 包 .: 测试 指定 类 : 


请 输入 测试 包 名 | 请 输入 测试 类 名 





` 
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图 14-10 ”monkey 调 试 类 命令 设计 界面 


调试 类 命令 除了 “出 错 后 继续 运行 ”和 “生成 profilfing report” 两 项 可 添加 外 ， 其 余 参 数 主 要 用 


再 次 强调 : 


i XJ OE TU e, 


14.3 monkey 脚 本 录制 工具 开发 


$e 
a 


sg 哎 ， 说 到 monkey 的 脚本 录制 ， 我 想 说 有 这 个 必要 吗 ? 


2... 我 只 想 说 : 存在 即 是 合理 ! 





对 于 monkey 录 制 工具 ， 如 果 你 还 继续 问 ， 那 巴 哥 奔 只 能 说 : 很 多 东西 ， 喝 着 咖啡 闲 扯 总 是 看 起 来 很 美 ， 只 有 实际 做 了 ， 掉 坑 里 了 ， 疏 起 来 再 掉 坑 里 ， 摔 得 


考 。 不 然 古人 为 什么 说 : 纸 上 得 来 终 觉 浅 ， 方 知 此 对 





BEST (不 是 官 刑 ) 。 





如 果 你 还 想 问 ， 那 巴 哥 奔 只 能 叹 口气 站 起 来 ， 对 你 唱 到 : 
Only you，monkey 小 工具 多 简便 (BREA) ! 


Only you，monkeyrunner 很 难 用 


Only you， 如 果 你 想 搞定 工作 而 不 是 玩 票 ( 即 录 即 得 ， 运 行 百 遍 ， 要 的 就 是 高 效 ) ! 





那 你 就 应 该 考虑 开发 一 款 与 之 匹配 的 超 轻 量 级 录制 小 工具 





14.3.1 monkey 脚 本 录制 工具 需 : 


$ C 











(依靠 PC 端 鼠 标点 击 和 选项 操作 绝对 是 本 世纪 最 反 人 性 的 自动 化 工具 设计 ) | 


好 路 ， 玩 笑 归 玩 笑 ， 当 我 们 真正 静 下 心 来 开发 这 款 提升 效率 的 小 工具 时 ， 难 题 出 现 了 : 从 何 处 下 手 ? 


当 遇 到 这 类 问题 ， 没 有 人 跟 你 提 需 求 ， 而 你 又 很 难 把 自己 的 需求 想 透彻 ， 那 么 ,我 们 就 一 定 要 学 会 逆向 思维 。 


Se 
全 我 们 该 如 何 北向 思维 呢 ? 














于 命令 行 调试 ， 不 适用 于 工具 选择 或 显示 。 


清 大 家 根据 项 目 需要 进行 设计 ， 但 大 致 功能 就 是 这 些 ， 供 大 家 根据 项 目 需要 进行 增删 选择 。 

















脸 是 血 、 没 了 脾气 ， 才 会 坐 在 坑 边 重新 思 


eo., 从 终极 目标 开始 往 回 想 ， 我 们 的 终极 目标 是 什么 呢 ? 





























我 们 的 终极 目标 应 该 是 一 款 可 以 直接 录制 界面 操作 ， 并 可 直接 生成 monkey 脚 本 的 超 轻 量 级 小 工具 。 





那么 ， 我 们 现在 的 需求 可 拆 分 变 为 两 个 。 
1) 识别 用 户 对 界面 的 操作 动作 。 
2) 将 识别 到 的 动作 转换 成 monkey 脚 本 对 应 的 命令 。 


既然 需求 摆 在 那里 ， 那 就 一 起 来 看 看 都 有 哪些 技术 难点 亚 待 解决 吧 ! 


143.2 ”monkey 脚 本 录制 工具 设计 


EC 
人 首先 处 理 第 一 个 问题 : 如 何 识别 用 户 对 界面 的 操作 动作 ? 


$9, oon. 





识别 用 户 对 界面 的 操作 动作 ， 如 图 14-11 所 示 。 


1) PC 端 创建 ServerSocket 实 例 ， 方 法 如 下 。 





ServerSocket ss = new ServerSocket (this.port); 





2) PC 端 循环 等 待 连接 请 求 ， 并 通过 ServerSocket 的 accept() 方 法 为 下 一 个 传 入 的 连接 请 求 创建 socket 实例 ， 如 下 。 





Socket s = ss.accept(); 





3) 手机 端 创建 socket， 指 定 远程 地 址 和 端口 号 ， 以 便 手 机 端 能 向 PC 端 发 送 请 求 。 





Socket s = new Socket( IP, Ports ) 





— PC 端 创建 ServerSocket 实 例 
_“ PC 端 循环 等 待 连接 请 求 
+ 手机 端 创建 Socket， 指 定 远程 地 址 和 端口 号 -— 


一 一 一 读 取 设备 上 的 framebuffer 











一 一 一 BEURBEE | 


“循环 读 取 Socket 输 入 流 中 的 内 容 对 用 户 操 作 进 行 捕获 


co. 跨 进程 模拟 事件 处 理 ， 


图 14-11 识别 用 户 对 界面 的 操作 动作 





4) 手机 端 与 PC 端 连接 成 功 后， 接 下 来 就 要 读 取 设备 上 的 framebufer， 如 代码 清单 14-1 所 示 。 


代码 清单 14-1 ” 读 取 设备 上 的 framebufer 





// xuben: 通过 ServiceManager 获 得 "window" service 的 Binder， 

// 以 便 调用 它 所 对 应 的 WindowManager 的 内 部 接口 来 进行 事件 触发 

IBinder wmbinder = ServiceManager.getService ("window"); 

final IWindowManager wm = IWindowManager.Stub.asInterface (this.wmbinder); 
// xuben: 读 取 设 备 上 的 framebufer - 

Process p = Runtime.getRuntime() .exec("/system/bin/cat /dev/graphics/fb0"); 
InputStream is = p.getInputStream(); 

BuferedReader r = new BufferedReader (new InputStreamReader (is) ); 

line = r.readLine(); 

OutputStream os = s.getOutputStream(); 





全 < 为 什么 要 读 取 设 备 上 的 Framebufer? 


RO, 为 手机 端的 图 像 信息 都 是 通过 FrameBufetr 这 个 设备 写 到 手机 屏幕 上 去 的 ， 所 以 可 以 通过 读 取 此 设备 中 的 数据 来 获取 当前 正在 显示 的 图 像 。 





gpk Wd "/system/bin/cat/dev/graphics/fb0". 3 X 4T 4 EB? 


| TER “/dev/graphics/fb0”， 这 里 通过 上 述 代 码 读 取 屏幕 图 像 数 据 ， 进 而 获取 手机 屏幕 信息 





， 如 代码 清单 14-2 所 示 。 











下 面 ， 通 过 device 的 getScreenshot() 方 法 获取 屏幕 截 | 


[ 





代码 清单 14-2 ”获取 屏幕 截图 











// xuben: 通过 DDMS 的 ADB 接 口 进行 通信 
AndroidDebugBridge bridge = AndroidDebugBridge.createBridge(); 
waitDeviceList (bridge); 
IDevice devices[] = bridge.getDevices(); 
// xuben: 通过 device.getScreenshot () 获取 屏幕 截图 
RawImage rawImage = null; 
synchronized (device) ( 
rawImage = device.getScreenshot (); 


} 


本 截屏 的 代码 吗 ? 就 是 通过 上 述 方法 获取 的 。 

















它 的 截图 调用 包 “com.android.chimpchat.core.Ichimplmage” 来 实现 ， 它 的 调用 链 为 device.getScreenshot(0 一 AdbHelper.getFrameBufer 一 formAdbRequest("framebufer ")。 





























这 样 一 来 ， 就 可 以 通过 循环 读 取 Socket 输 入 流 中 的 内 容 对 用 户 操作 进行 捕获 ， 如 代码 清单 14-3 所 示 。 





代码 清单 14-3 ”对 用 户 操作 进行 捕获 





BuferedReader br = new BuferedReader( new InputStreamReader (socket.getInputStream())); 
String content - null; 
// xuben: 循环 读 取 Socket 输 入 流 中 的 内 容 
while ((content = br.readLine()) != null) 


{ 
// xuben: 对 接收 到 的 数据 进行 对 应 操作 
} 





对 应 事件 参数 则 通过 IWindowManager 接 口 的 finjectPointerEvent()、finjectKeyEvent() 或 finjectTrackballEvent0) 方 法 分 别 进行 跨 进程 模拟 事件 处 理 ， 如 代码 清单 14-4 所 示 。 








代码 清单 14-4 ” 跨 进 程 模拟 事件 处 理 





// xuben: 创建 IwindowManager 接 口 对 象 
final IWindowManager wm = IWindowManager.Stub.asInterface (this.wmbinder); 
// xuben: 这 里 通过 InputStream 获 取 的 line 由 type 和 paramList， 
// type 对 应 事件 类 型 ， 而 paramList 对 应 事件 
String[] paramList = line.split("/"); 
String type - paramList [0]; 
if (type.equals ("quit")) { 
System.exit (0) ; 
return; 
l 
// xuben: 注入 点 击 事件 
if (type.equals("pointer")) { 
this.wm.injectPointerEvent (getMotionEvent (paramList), false); 
return; 
l 
// xuben: 注入 key 事 件 
if (type.equals ("key")) { 
this.wm.injectKeyEvent (getKeyEvent (paramList), false); 
return; 


$ 

// xuben: 注入 轨迹 球 事件 

if (type.equals("trackball")) { 
this.wm. injectTrackballEvent (getMotionEvent (paramList), false); 
return; 


} 





备注 : 
finjectPointerEvent/finjectKeyEvent/finjectTrackballEvent 为 WindowsManaget 中 的 内 部 接口 ， 对 应 的 代码 位 置 : 


“~ [frameworks /base/services/j ava/com/android/server/wm/WindowManagerService.j ava” o 





这 个 代码 有 种 似曾相识 的 感觉， 难道 我 做 梦 梦 到 过 ? 


26... 基本 原理 来 自 Android 的 开源 项 目 AndroidScreencast。 








Android 的 开源 项 目 AndroidScreencast 官 网 地 址 : http://code.google.com/p/androidscreencast/。 

















起 来 了 ， 某 年 某 月 的 某 一 天 曾经 浏览 过 ， 不 过 没 看 懂 。 
QO, casum 你 对 Android 基 本 的 自动 化 原理 已 经 有 所 了 解 ， 不 过 光 知 道 是 远 远 不 够 的 ， 关 键 还 是 如 何 为 我 所 用 。 
接 下 来 ， 我 们 一 起 来 看 看 如 何 将 识别 到 的 动作 转换 成 monkey 脚 本 对 应 的 命令 吧 ! 


14.3.3 ”monkey 脚 本 录制 工具 原理 


eo, 这 里 ， 是 时 候 回顾 一 下 monkey 的 脚本 了 。 
以 打开 浏览 器 脚本 为 例 ， 如 代码 清单 14-5 所 示 。 


代码 清单 14-5 ”打开 浏览 器 脚本 





#Start Script 
type = user 
count - 10 
speed = 1.0 
start data »» 


LaunchActivity (com. android.browser, com.android.browser.BrowserActivity) 
UserWait (5000) 

# 发 送 后 退 键 

DispatchPress (KEYCODE BACK) 

UserWait (2000) 

Vd as 

captureDispatchPointer (5109520, 5109520, 0,725, 687,0,0,0,0,0,0,0) ; 
captureDispatchPointer (5109521,5109521,1,725,687,0,0,0,0,0,0,0) ; 





< 全 % 这 段 脚本 看 上 去 捍 简 单 的 ， 咱 们 如 何 自动 生成 这 样 的 脚本 呢 ? 


2 要 生成 这 样 的 脚本 ， 最 主要 的 是 对 动作 的 翻译 ， 比 如 对 后 退 键 的 识别 ， 对 坐标 点 等 参数 (包括 案件 时 间 、 事 件 发 生 时 间 和 动作 等 ) 的 识别 等 。 


如 果 要 生成 这 样 的 脚本 ， 流 程 如 图 14-12 所 示 。 








mw 


将 用 户 动作 翻译 为 

|... 对 应 monkey 语 名 

— ( 如 捕获 到 点 击 
后 退 键 动作 ) 








一 。 捕获 用 户 动作 参见 上 一 忆 


该 动作 匹配 的 事件 : 
如 调用 按键 发 送 方法 


> 该 动作 对 应 的 参数 : 


如 后 退 键 ( KEYCODE BACK ) 
, 如 果 是 点 击 事件 则 需 获取 坐标 点 信息 


一 一 将 方法 和 参数 组 合 为 monkey 语 句 


< 全 % 上 一 节 讲 了 如 何 捕获 用 户 动作 ， 那 现在 该 讲 动作 翻译 了 吧 ? 


图 14-12 ”生成 monkey 脚 本 流程 


eo 由 于 动作 事件 是 通过 调用 WindowManagetrService 中 UI 交 互 的 注入 方法 ， 所 以 需要 为 finjector 的 ScreenCaptureThread 设 置 监听 。 


为 finjector 的 ScreenCaptureThread 设 置 监听 ， 如 代码 清单 14-6 所 示 。 


代码 清单 14-6 ”设置 监听 





private IDevice device; 
private Injector injector; 
private Dimension oldImageDimension = null; 
public void setInjector(Injector injector) ( 
this.injector - injector; 
// xuben: 设置 监听 
injector.screencapture.setListener (new ScreenCaptureListener() { 
public void handleNewImage (Dimension size, BuferedImage image, 
boolean landscape) { 
if (oldImageDimension == null || 
!size.equals (oldImageDimension)) { 
jsp.setPreferredSize (size); 
JFrameMain.this.pack(); 
oldImageDimension - size; 


jP.handleNewImage (size, image, landscape); 





ScreenCaptureThread 如 代码 清单 14-7 所 示 。 


代码 清单 14-7 ”ScreenCaptureThread 





public ScreenCaptureThread screencapture; 
public Injector(IDevice d) throws IOException { 
this.device - d; 
this.screencapture = new ScreenCaptureThread (d); 





接 下 来 ， 对 具体 事件 进行 监听 ， 首 先 需要 创建 适配器 ， 如 代码 清单 14-8 所 示 。 





代码 清单 14-8 ”创建 适配器 





MouseAdapter ma = new MouseAdapter() ( 
// xuben: 重 写 拖 搜 方法 


GOverride 
public void mouseDragged (MouseEvent arg0) { 
if (injector -- null) 
return; 
try { 


// xuben: 通过 JpanelScreen 的 getRawPoint () 获取 坐标 
Point p2 = jp.getRawPoint (arg0.getPoint ()); 
// xuben: 通过 injector 的 injectMouse () 注 入 事件 ， 后 将 详 述 
injector.injectMouse (ConstEvtMotion.ACTION MOVE 

r p2.x, p2.y); 








} catch (IOException e) { 
throw new RuntimeException (e); 


} 
} 
// xuben: 重 写 按 下 方法 


GOverride 
public void mousePressed(MouseEvent arg0) { 
if (injector -- null) 
return; 
tr 


Y 1 
// xuben: 同上 


Point p2 = jp.getRawPoint (arg0.getPoint ()); 
injector.injectMouse (ConstEvtMotion.ACTION DOWN 
| P2.X, p2.y); 
} catch (IOException e) ( 
throw new RuntimeException (e); 
} 


l 
// xuben: 重 写 弹 起 方法 
GOverride 
public void mouseReleased(MouseEvent arg0) ( 
if (injector -- null) 
return; 
try { 
if (arg0.getButton() == MouseEvent.BUTTON3) { 
injector.screencapture.toogleOrientation (); 
arg0.consume () ; 
return; 
l 
// xuben: 同上 
Point p2 = jp.getRawPoint (arg0.getPoint ()); 
injector.injectMouse (ConstEvtMotion.ACTION UP, p2.x, p2.y); 
] catch (IOException e) ( 
throw new RuntimeException (e); 
} 


} 
// xuben: 重 写 轨迹 球 方法 


GOverride 
public void mouseWheelMoved (MouseWheelEvent arg0) ( 
if (injector -- null) 
return; 
try { 
injector. injectTrackball (arg0.getWheelRotation() < 0 ? -1f 


i Lt); 
} catch (IOException e) { 
throw new RuntimeException (e); 


} 
HN 





创建 适配器 ， 如 图 14-13 所 示 。 





通过 JpanelScreen 的 getRawpPoint() 获 取 坐 标 


“ 重 写 拖 搜 方法 © 通过 injector 的 injectMouse() 注 入 事件 










一 一 。 重 写 按 下 方法 o 同上 


— 重 写 弹 起 方法 o 同上 


2 重 写 轨迹 球 方法 = 同上 








图 14-13 ”创建 适配器 











创建 好 适配器 后 ， 就 可 以 为 具体 事件 增加 监听 了 ， 如 代码 清单 14-9 所 示 。 


代码 清单 14-9 ”增加 事件 监听 





// xuben: 移动 事件 监听 
jp.addMouseMotionListener (ma); 
// xuben: 按键 事件 监听 
jp.addMouseListener (ma) ; 

// xuben: 轨迹 球 事件 监听 
jp.addMouseWheelListener (ma); 





六 还 是 说 说 注入 事件 吧 ， 主 要 做 些 什么 ? 


99, 我 们 一 起 来 看 看 ! 








创建 适配器 时 ， 最 重要 的 就 是 通过 finjector 的 finjectMouse() 方 法 注入 事件 ， 如 代码 清单 14-10 所 示 。 








代码 清单 14-10 ”通过 finjector 的 finjectMouse(0) 注 入 事件 





// xuben: 注入 事件 
public void injectMouse(int action, float x, float y) throws IOException 


{ 
// xuben: 预 设 按 下 时 间 和 事件 发 生 时 间 
long downTime = 10; 
long eventTime = 10; 
int metaState = -1; 
// xuben: 生成 monkey 命 令 字符 串 
String cmdListl = "pointer/" + downTime + "/" + eventTime + "/" 
+ action + "/" +x + "/" + y + "/" + metaState; 
// xuben: 注入 monkey 命 令 
injectData (cmdListl); 





人 哈哈， 到 这 里 ，monkey 命 令 语句 就 顺利 生成 了 ! 


85,, cesa, 我 们 就 可 以 按照 第 一 部 分 介绍 的 方法 直接 在 命令 行 对 其 进行 运行 了 ， 效 率 提高 何止 十 倍 ? 


144 monkey 工 具 总 结 


OS cw, 不 错 ， 传 参 小 工具 大 大 降低 了 测试 出 错 率 ; 录制 小 工具 则 大 大 提高 了 测试 效率 1 


$99... 谢谢 BOSS1! 


b 
呵呵， 通过 这 两 个 小 工具 的 开发 ， 我 发 现 自己 功力 也 大 大 提升 了 ，yes! 


is 


te 
区 其 实 很 多 小 工具 ， 看 上 去 简单 ， 但 设计 起 来 还 是 要 花 一 番 心 思 的 。 而 且 做 出 来 还 真能 降低 大 家 的 出 错 率 ， 有 成 就 感 ! 





还 有 的 小 工具 ， 虽 然 看 上 去 复杂 ， 但 一 点 点 地 分 解 为 多 个 步骤 ， 再 一 个 个 攻克 难关 ， 最 后 一 组 装 ， 还 真 就 做 出 来 了 。 
BOn, 天 下 事 有 难 易 乎 ? AZ, MERDA! 


eo... 既然 如 此 ， 那 就 抓紧 开发 下 一 款 小 工具 吧 ! 


第 15 章 ”从 Instrumentation 到 稳定 自动 化 工具 开发 





Instrumentation 框 架 很 强大 ， 那 咱们 还 能 基于 它 做 哪些 事情 ? 


15.1 为 何 要 做 二 次 封装 ? 


eo, . 定 针对 Instrumentation 做 二 次 封装 ! 
E] 

人 《运行 得 好 好 的 ， 干 嘛 没事 找事 ? 
959,5 过 程 中 没 发 现 它 的 不 足 吗 ? 


f» 
人 不足 当 然 有 ， 但 也 没 必要 浪费 时 间 自 己 去 做 。 再 说 ， 国 外 也 有 很 多 成 型 的 二 次 封装 的 框架 ， 比 如 Robotium， 所 以 应 该 站 在 巨人 的 户 上 ， 而 不 是 重新 造 轮子 。 





对 于 这 类 言论 ， 巴 哥 奔 只 能 选择 沉默 一 一 没有 真正 实践 过 ， 空 口 白 说 解决 不 了 问题 。 














别 说 当时 Android 自 动 化 的 倚天 剑 (UIAutomator) 还 没 诞生 ， 就 算 在 倚天 剑 诞生 的 今日 ， 仍 有 很 多 解决 不 了 或 需要 与 层 龙 刀 (Instrumentation) 互补 的 方面 。 站 在 巨人 的 肩 上 这 句 话 ， 谁 都 会 说 ， 
但 如 果 立 足 于 实际 项 目 ， 立 足 于 实际 的 测试 工作 和 需求 ， 不 仅 需 要 灵活 地 应 用 各 种 武器 ， 更 需要 适时 地 改进 武器 ， 使 武器 的 威力 发 挥 到 极致 。 















































所 以 ， 与 其 反复 争执 是 否 需要 对 Instrumentation 二 次 封装 ， 不 如 看 看 需要 解决 的 问题 和 需求 都 是 什么 ， 进 而 反思 现 有 的 武器 都 有 哪些 功能 与 不 足 。 





eo 既然 你 提 到 Robotium， 那 你 觉得 它 的 优点 都 有 哪些 ? 


Bak, 它 对 Instrumentation 做 了 很 多 封装 ， 提 供 了 更 易 上 手 的 一 系列 API， 降 低 了 初学 者 的 门槛 。 

其 次 ， 它 也 更 易 进 行 集成 测试 (可 在 一 个 测试 过 程 中 同时 测试 多 个 活动 ) 。 

第 三 ， 它 与 黑 盒 测试 用 例 步 骤 的 匹配 度 也 更 好 〈 这 也 归功 于 封装 后 的 API 更 人 性 化 ) 。 

e... 看 来 你 用 过 一 段 时 间 ， 那 它 的 缺点 在 哪 呢 ? 

B sonda eee Robotium 更 倾向 于 降低 Instrumentation 的 难度 ， 而 非 解 决 其 框架 本 身 的 问题 。 

比如 ，Robotium 提 供 的 API 虽 然 在 一 定 程度 上 降低 了 门槛 ， 但 带 来 的 一 大 问题 就 是 : 其 代码 的 可 扩展 性 也 变 得 较 差 。 
而 Instrumentation 对 控件 〈 尤 其 是 网 页 控件 ) 的 识别 能 力 弱 的 问题 在 Robotium 上 也 没 得 到 很 好 的 解决 。 


$e, 它 最 大 的 问题 是 ， 咱 们 没 办 法 根据 具体 项 目 进行 定制 化 设计 。 


























举 个 例子 ， 当 Instrumentation 框 架 对 应 用 控件 的 抓 取 常 常 出 现 有 的 控件 无 1D 或 多 个 控件 ID 重复 的 情况 ， 如 果 不 进行 封装 ， 将 会 出 现 一 系列 识别 问题 ， 这 些 问题 将 大 大 影响 自动 化 脚本 的 稳定 性 和 通 
性 ， 而 Robotium 这 类 封装 并 没有 解决 这 些 问 题 ， 如 图 15-1 所 示 。 



































控件 ID 重复 


一 一 一 一 一 -一 一 一 一 一 一 一- 一- 
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图 15-1 控件 无 ID 或 控件 ID 重复 


A 那 咱们 不 是 可 以 通过 UIAutomator 来 弥补 Instrumentation 的 不 足 吗 ? 


eo... 看 来 你 用 过 一 段 时 间 ， 那 它 的 缺点 在 哪 呢 ? 


E 


必 首 先 ， 难 以 捕获 控件 颜色 等 详细 信息 ; 


P 


其 次 ， 脚 本 稳定 性 较 差 ; 


第 三 ， 调 试 较为 困难 。 
全 不 过 这 些 不 是 正好 可 以 通过 Instrumentation 进 行 互补 吗 ? 


QS oe aurons 而 且 在 某 些 通用 性 用 例 上 的 确 也 有 这 方面 的 尝试 。 但 对 绝 大 多 数 有 独立 需求 的 项 目 而 言 ， 同 时 使 用 两 个 框架 将 带 来 更 大 的 灾难 。 


由 此 我 们 可 以 非常 清晰 地 得 出 几 点 。 











1) Instrumentation 自 身 能 力 : Instrumentation 框 架 本 身 当然 也 可 直接 使 用 一 一 前 提 是 玩 票 性 质地 试用 ， 而 非 大 规模 脚本 编写 ， 而 一 旦 需要 进行 大 规模 编写 ， 则 这 些 问题 将 大 大 影响 到 生产 的 效率 
一 一 即 自动 化 产 出 率 。 















































2) 普 适 性 封装 效果 : 如 Robotium 对 Instrumentation 的 封装 ， 在 一 定 程度 上 (甚至 绝 大 多 数 普 通 场景 下 ) 是 实用 的 ， 但 绝 非 万 能 解决 方案 ， 在 具体 项 目 中 更 显得 捉襟见肘 。 





























3) 多 框架 互补 范围 : 倚天 剑 (UlAutomator) 与 属 龙 刀 (Instrumentation) 是 互补 关系 ， 而 非 蔡 代 关系 。 当 我 们 开发 通用 性 用 例 时 可 以 考虑 这 种 互补 ， 但 在 绝 大 多 数 有 独立 需求 的 具体 项 目 中 ， 就 必 
须 充分 考虑 多 框架 并 行 的 风险 性 和 可 控 性 。 











基于 以 上 分 析 ， 我 们 应 该 沉 心静 气 ， 根 据 项 目的 实际 需要 对 Instrumentation 进 行 “猪尾 续 狠 ”、“ 鼠 尾 续 狠 ”和 “马尾 续 狠 ”， 以 期 具体 问题 具体 分 析 。 


全 那么 ， 在 实际 项 目 中 ，Instrtumentation 究 竞 有 哪些 需要 我 们 进行 二 次 封装 的 呢 ? 


15.2 ”如 何 做 Instrumentation 的 二 次 封装 


Oi 目 中 Instrumentation 究 竟 有 哪些 内 容 需 要 我 们 进行 二 次 封装 ， 最 好 的 办 法 莫 过 于 回 到 实际 场景 中 去 观察 。 
152.1 场景 1: 源码 问题 


Benito 目 ， 麻 烦 提 供 源 码 jar 包 ， 并 保证 更 新 源码 时 将 相应 将 更 新 jar 包 提供 给 我 。 


OS... 给 你 们 源码 jar 包 违反 了 公司 代码 安全 性 规定 。 


其 次 ， 研 发 进度 这 么 紧 ， 哪 有 时 间 和 人 和 手 为 你 们 单独 建 测试 分 支 。 

全 必 看 来 ， 我 们 的 测试 不 能 太 依赖 源码 jar 包 。 

Guz 当然 ， 也 不 是 每 个 研发 经 理 都 这 么 难 打交道 ， 但 如 此 多 的 产品 同时 上 线 ， 只 要 有 一 两 个 经 理 不 配合 ， 整 个 测试 计划 就 没 办 法 统一 。 
KAR OE AGE E A Dp? 

99... onn 调用 Android 框 架 层 API 拿 到 当前 Activity 的 所 有 View， 在 此 基础 上 返回 需要 获得 的 View 对 象 。 

s» 

Skk, ，Robotium 的 做 法 不 也 类 似 吗 ? 

e... 不 过 既然 Robotium 满 足 不 了 项 目 其 他 方面 的 需求 ， 那 在 二 次 封装 时 ， 先 把 Robotium 优 秀 的 地 方 学 过 来 ， 也 不 失 为 一 着 妙 棋 。 


15.22 35:92: 控件 问题 


eee eee eT 还 有 这 些 方法 ， 都 在 脚本 编写 标准 里 清 清楚 楚 地 注 明 了 用 法 的 ， 为 什么 还 是 用 错 ? 





性 这 几 个 控件 Instrumentation 都 没有 提供 实例 ， 调 用 起 来 好 麻烦 ， 这 些 方法 我 也 还 没 用 熟 。 

+ Pa 需要 对 这 些 常 用 控件 和 方法 进行 封装 了 。 

Oez 对 常用 控件 关键 操作 进行 二 次 封装 ， 可 以 最 大 程度 地 避免 新 入 职 的 小 弟 们 犯错 ， 进 一 步 提高 他 们 的 测试 效率 。 

s» 

SAIPALTA E A DVN? 

|  — 操作 ， 并 返回 操作 结果 。 

s» 

全 <%Robotium 不 也 做 了 很 多 类 似 封装 吗 ? 

| SOMME 重 基本 操作 ， 而 只 有 针对 不 同 项 目 需求 ， 对 不 同 控件 的 操作 进行 有 针对 性 的 封装 ， 才 能 极 大 地 提高 测试 人 员 的 效率 。 
15.2.3 15:3: 用 例 结构 问题 

$6, My God， 你 们 几 个 为 什么 一 上 来 就 瞎 写 脚本 ? 

现在 用 例 结构 极其 混乱 ， 要 知道 ， 这 些 用 例 不 是 运行 通过 就 OK 了 的 ， 更 重要 的 是 可 读 性 、 可 维护 性 和 可 移植 性 。 


你 们 这 些 用 例 写成 这 样 ， 未 来 除了 你 们 自己 ， 估 计 没 有 人 知道 当初 写 的 是 些 什么 ! 

LU 

人 性 哎 ， 好 烦 好 烦 ， 能 运行 不 报错 我 已 经 谢 天 谢 地 了 。 

eo.,. 需要 按照 项 目 需求 ， 尤 其 是 多 个 项 目 脚 本 移植 的 需求 ， 对 用 例 结 构 进 行 封装 ， 以 便 让 大 家 按照 统一 的 结构 进行 脚本 编写 。 


Oa 在 项 目 实际 和 运行 时 ， 尤 其 是 多 个 产品 之 间 存 在 大 量 的 脚本 移植 需求 时 ， 统 一 的 用 例 结构 尤其 重要 。 而 新 人 是 不 懂 什 么 用 例 结构 的 ， 与 其 费时 费力 写 规范 文档 ， 不 如 封装 一 个 用 例 结 构 让 大 
家 “ 照 猫 画 虎 ”。 


fe 
SAIMA E A I? 


Operze 更 符合 项 目 实际 需求 的 用 例 结构 ， 并 强制 大 家 按照 该 结构 进行 用 例 编 写 。 


界面 操作 封装 如 图 15-2 所 示 。 
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15-2 界面 操作 封装 











p 
SRA? ARË 

2 首先 ， 对 于 界面 控件 的 操作 进行 封装 ， 比 如 窗口 I 有 4 个 操作 ， 窗 口 2 有 3 个 操作 等 ， 把 这 些 操作 先 封装 起 来 。 
B ni 

SEA HE ZF ROE? 

?2 这 样 一 来 ， 在 具体 编写 测试 用 例 时 ， 只 需 根 据 用 例 步 又 调用 对 应 窗口 的 对 应 操作 就 行 ， 如 下 。 


测试 用 例 设计 如 图 15-3 所 示 。 





window1.operation1 
window1.operation2 
e window1.operation3 
window1.operationN 





testcasel 


window1.operation1 
window2.operation2 
ə window3.operation3 
window4.operation4 


^| testcase2 | 





window1.operation1 

| rwindow1.operation2 
e window2.operation1 
window3.operation1 


testcase3 


window1.operation1 
|. rwindow2.operation1 
e window4.operation3 
windowN.operationN 





testcaseN 


图 15-3 测试 用 例 设 计 
全 % 额 ， 这 就 更 看 不 懂 了 ! 解释 一 下 吧 ! 
ee ne 比如 我 们 需要 一 个 测试 用 例 ， 首 先进 入 联系 人 列表 ， 选 择 联系 人 已 哥 奔 ， 界 面 跳 转 到 巴 哥 奔 详 细 信息 ， 此 时 选择 短信 ， 界 面 跳 转 到 短信 窗口 ， 然 后 编辑 短信 后 发 送 。 
$5... sn, 联系 人 列表 窗口 为 窗口 1， 巴 哥 奔 详细 信息 窗口 为 窗口 2， 短 信 窗 口 为 窗口 3。 
如 果 在 联系 人 窗口 中 选择 巴 哥 奔 为 对 窗口 1 的 操作 1， 而 在 巴 哥 奔 详 细 信 息 窗口 中 选择 短信 为 对 窗口 2 的 操作 3， 在 短信 窗口 编辑 短信 为 对 窗口 3 的 操作 1， 点 击发 送 为 对 窗口 3 的 操作 4。 
E 
SCRA IPRS T V 那 你 刚才 所 描述 的 这 个 测试 用 例 是 不 是 这 样 ? 


测试 用 例 示例 如 图 15-4 所 示 。 





- windowloperationl ‘= 联系 人 窗口 .选择 巴 哥 奔 





| — —| window2.operationa cr 巴 哥 奔 详细 信息 窗口 .选择 短信 





一 Window3.operationl © 1215 9 〇 .编辑 短信 


/ 


window3.operationa 5" 短 信和 窗口 .点 击发 送 


图 15-4 ”测试 用 例 示例 
|_ pp 这 样 一 来 ， 之 前 针对 窗口 封装 的 方法 在 用 例 里 直接 调用 即 可 。 不 仅 用 例 的 开发 效率 大 大 提高 ， 而 且 用 例 结构 也 非常 规范 ， 问 题解 决 ! 


1524 1584: 运行 日 志 问 题 


QOO, ken 最 近 总 在 抱怨 用 例 失败 后 没 法 复 现 ， 直 接 报 bug 也 因为 log 不 足 被 打 回 ， 你 们 就 不 能 加 入 更 详细 的 log 吗 ? 


E 

SSF, 老大， 每 天 加 班 加 点 地 编写 、 调 试 和 移植 ， 哪 还 有 时 间 帮 他 们 加 这 么 多 logr 阿 ， 用 默认 的 log 就 好 了 嘛 ! 
eo... 需要 将 项 目 所 需 的 log 都 给 你 们 封装 好 。 

lo 如 果 需 要 更 详细 的 运行 日 志 (包括 运 行 状况 、 出 错 原因 和 代码 定位 等 ) ， 最 好 单独 建立 一 套 log 机 制 供 新 人 调用 。 
2 ; 
从 奔 哥 ， 如 果 能 确保 不 增加 太 多 工作 量 ， 我 也 是 愿意 配合 的 ! 嘿嘿 ! 


99... 看 来 我 们 需要 建立 一 套 log 机 制 ， 将 所 需 log 都 封装 到 里 面 ， 这 些 log 将 直接 存储 到 测试 机 的 SD 卡 中 或 直接 传 到 云端 。 


D OT€— 而 很 少 关注 log 的 有 效 性 ， 而 在 实际 项 目 中 ，log 却 是 非常 重要 的 一 环 。 对 于 那些 突 发 性 问题 ， 复 现 起 来 极其 困难 ， 此 时 一 份 丰 富 的 运行 日 志 将 极 大 地 保 
证 问题 的 定位 。 


15.2.5 “场景 5: 窗口 监测 问题 

BO anaana atan 

最 近 的 用 例 为 什么 总 是 这 样 不 稳定 ? 
se 
-我 也 不 知道 ， 感 觉 像 是 遇 到 和 鬼 了 1! 
| TP; 你 没 发 现 很 多 时 候 界面 还 没 来 得 及 切换 ， 针 对 新 界面 的 代码 就 已 经 执行 了 吗 ? 这 样 一 来 ， 执 行 不 失败 才 怪 ! 
E aa f 
全 孝 哦 ， 那 我 多 加 点 等 待 时 间 。 以 后 每 个 操作 都 等 99 秒 再 执行 ! 


¢ 3 你 想 气 死 我 吗 ? 


Qez 新 人 往往 对 执行 间隔 没 概念 ， 要 么 在 界面 尚未 跳 转 时 就 执行 新 界面 代码 ， 要 么 就 设置 漫长 的 等 待 时 间 。 这 在 实际 项 目 中 都 将 得 不 偿 失 〈 试 想 ， 一 个 操作 步骤 等 待 1 分 钟 ， 那 么 一 条 用 例 需要 等 
待 多 久 ， 一 个 用 例 集 又 需要 等 竺 多久， 如 果 每 天 需要 执行 多 个 用 例 集 ， 且 每 个 用 例 集 需要 执行 很 多 遍 ， 那 执行 一 遍 测 试 又 得 等 待 多 久 ) 。 
VG UR E A Ip? 


3 最 好 的 方式 自然 是 对 窗口 变更 进行 监测 ， 只 要 监测 到 界面 跳 转 ， 立 即 执行 用 例 。 


监测 新 窗口 跳 转 ， 具 体 做 法 如 图 15-5 所 示 。 





监测 窗口 变更 - 























E 
SK 对 窗口 变更 进行 监测 这 个 方法 好 是 好 ， 但 新 人 往往 写 不 出 这 样 高 难度 的 代码 ， 就 算 写 出 也 错漏 百出 。 


2°... 为 这 样 ， 所 以 这 些 代码 必须 由 经 验 丰 富 的 人 员 进 行 封装 ， 以 供 新 人 调用 。 





QOO, nn 你 们 怎么 都 标记 为 无 法 自动 化 ? 


fe 

全 《这些 用 例 所 涉及 的 控件 要 么 就 是 ID 重 复 ， 要 么 ID 完全 没有 。 

eo, 不 是 所 有 UI 的 ID 值 在 R.java 中 都 有 定义 ， 这 就 意味 着 无 法 通过 ID 值 来 定位 所 有 的 UI。 
如 下 图 中 的 两 个 ListMenuItemView 的 ID 值 并 没有 在 R.java 中 定义 ， 所 以 无 法 通过 ID 值 获取 。 


另外 两 个 TextView 属 于 控件 ID 均 为 “tite”， 所 以 的 确 很 难 获取 。 





控件 无 1D 和 控件 ID 重复 ， 如 图 15-6 所 示 。 











29 views 


Measure 4548 ms 
Layout: 4.712 ms 
Draw: 1965 ms 

















定义 一 个 Service 用 来 监测 窗口 的 变更 ， 


并 在 窗口 刷新 完成 的 时 候 ， 返 回 一 个 事件 给 框架 


当 UI 操 作 可 能 会 引起 窗口 变化 时 ， 
只 需要 调用 WindowManager 定 义 的 


ge 确保 新 窗口 刷新 完成 O waitForEvent() 方 法 来 等 待 Service 返 回 的 事件 , 


方法 返回 时 新 窗口 确保 已 刷新 完成 


当 WindowManager 等 到 Service 返 回 的 事件 时 , 
就 会 通过 java 反射 来 获取 当前 窗口 ， 并 赋值 给 topWindow。 


-确保 获得 最 上 层 窗 口 ”二 ”这样 便 能 保证 每 次 调用 WindowManager.getTopWindow 时 


都 能 得 到 最 上 层 的 窗口 ， 且 该 窗口 已 经 刷新 完成 


15-5 监测 新 窗口 跳 转 


控件 ID 重复 


15-6 控件 无 ID 和 控件 ID 重复 


E 
全 情况 就 是 这 么 个 情况 ， 所 以 我 们 只 好 标记 为 无 法 自动 化 了 。 


QO, ue sacer xi 看 来 还 是 得 封装 一 些 方法 让 大 家 快速 定位 控件 。 

Grex 当 两 个 甚至 多 个 控件 ID 重复 时 ， 尤 其 是 当 这 些 重复 ID 的 控件 处 于 同 级 目录 时 ，Insttrumentation 在 调用 控件 时 往往 会 报错 ， 而 控件 ID 缺失 对 于 Instrumentation 框 架 而 言 更 是 灭顶 之 灾 。 
$» 

SAB PARIA de AT Ab 39 V0? 

E O 当 同 级 目录 中 DD 重复 或 缺失 时 ， 我 们 需要 通过 查询 View 的 其 他 属性 (text、class 和 index 等 ) ， 对 整个 树 状 菜单 进行 定位 。 

| TTC 定位 后 可 通过 查找 子 节点 的 index 等 办 法 进行 遍历 ， 直 到 定位 到 所 需 查 找 的 控件 位 置 。 

fo 

人才 奔 哥 ， 这 种 方法 能 保证 万 无 一 失 吗 ? 

PS pn 当 树 状 菜单 结构 发 生变 化 时 尤其 如 此 。 如 果 一 味 逃 避风 险 ， 那 什么 都 做 不 成 。 

$6, 使 用 方案 时 一 定 要 权衡 具体 项 目 选 代 时 哪些 因素 变动 可 能 性 最 大 。 尽 可 能 地 绕 开 变动 大 的 因素 ， 而 采用 变动 最 小 的 因素 ， 以 确保 脚本 稳定 性 。 


152.7 场景 7: 出 错 截屏 问题 


Ra 试 执行 团队 提出 需求 ， 希 望 我 们 的 脚本 能 在 出 错 后 截图 。 
E 

人 这 个 很 麻烦 ， 如 果 出 错 较 多 将 会 存在 空间 不 足 的 风险 。 

eo, 们 是 结果 导向 的 ， 不 能 因为 有 问题 就 不 去 做 ! 

fe 

全 我 不 知道 该 怎么 办 ? 

;ng 比如 每 次 将 上 次 执行 时 的 存档 文件 清除 ， 或 定时 上 传 文件 并 清理 存储 空间 等 。 
E 

< 人 我 怕 将 需要 的 文件 清除 了 ， 或 是 将 很 多 没 用 的 文件 留 下 来 。 

= 

EER, BRARED ikih Ad dg. 


Oez 对 于 自动 化 框架 开发 人 员 ， 尤 其 是 针对 现 有 框架 二 次 封装 人 员 而 言 ， 不 能 要 求 新 人 具备 多 高 的 开发 技术 或 多 么 丰富 的 测试 经 验 ， 能 提前 预料 到 问题 并 进行 周全 考虑 。 


SAB GEEZ De? 





| oes 截图 保存 、 截 图 上 传 和 截图 清理 等 相关 工作 按照 一 定 罗 辑 封装 好 ， 以 最 简单 的 方式 《最 好 是 一 个 接口 ， 如 果 项 目 需要 更 灵活 可 考虑 多 个 组 合 接口 ) 提供 给 脚本 开发 人 员 。 























E 
cg pali RUE! 


$9... oss, 是 将 所 面临 的 需求 按照 一 定 的 规则 和 逻辑 封装 好 ， 新 人 撰写 脚本 时 只 需 简单 调用 即 可 。 


15.3 ”二 次 封装 改进 项 总 结 


-全 改 奔 哥 ， 为 什么 咱们 这 章 完全 不 贴 代码 供 大 家 参考 呢 ? 

99, akut hne ena, 这 里 提供 的 解决 方案 只 是 针对 当前 问题 给 大 家 的 一 个 参考 ， 和 希望 大 家 根据 实际 需求 进行 更 好 的 设计 。 
Se 

人 是 的 ， 虽 然 没 贴 代码 ， 但 感觉 咱们 要 做 的 工作 比 之 前 多 多 了 1! 


Pana, 那 咱们 简单 总 结 一 下 本 次 改进 项 吧 ! 


Instrumentation 二 次 封装 改进 项 ， 如 图 15-7 所 示 。 








Xj eH) 


___ 某 些 控件 无 实例 _ 
用 例 结构 混 她 __ 

无 法 监测 窗口 的 变更 | 
无 去 区 分 相同 结构 的 UL | 
_ 无 法 定位 无 1D 值 的 UI 
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封装 后 O 


EN ANM 
C B&iGE | 

可 监测 窗口 变更 | 
ASEAN |] 
DU] 
esa O] 























Here J | 
| | 


图 15-7 Instrumentation 二 次 封装 改进 项 


第 16 章 ”从 UIAutomatorViewer 到 PC 端 脚本 录制 工具 开发 


Le 很 强大 ， 如 果 进 行 改进 是 更 好 还 是 更 坏 ? 咱们 拭目以待 ! 


16.1 从 UIAutomatorViewer 原 理 说 开 来 
qo. 


让 我 们 一 起 回顾 一 下 第 一 次 见 到 Android 自 动 化 的 倚天 剑 一 一 UIAutomatorViewetr 时 的 情景 。 


UIAutomatorViewer 界 面 如 图 16-1 所 示 。 





« © ‘1. d0,8 18:09 Få 


bugben È} (0) PrameLayout [0,0 540,960] 
i a 所 t =. E (0) Linesrlayout (0,07540,960) 
请 在 下 框 中 输入 希望 修改 的 文字 : Rd 
pd (0) TextView:bugben [6,391 534,74] 
ZAE : 小 简洁 B £3) Promod [0,76540,9640] 
E (0) TableLarcut [0,76 [540,960 


) 
(0) TextView- iE T P8 ^M SE OTRO TES : [0,761540,117] 
ves AXE Bugben QO:1971629467 S (1) TableRom [0,117] 540, 188] 
(0) Text View: E D Ese! 167] 


EdtT 1 164,11 
请 选择 你 喜欢 的 颜色 : Se Takeo lo, EEJ 
=. (0) Tex XEF: [0,206y164,239] 
(9 Here Bugben QQ:1971629467 [164,1891483,261]) 
(3) Tet vier iE 1 FS AMR, : (0,261 540,302) 
S (4) TableRow [0,302 540,374] 
(0) Te TUER: 
由 (1) RadioGroup [16 64,302 [489,37 à 
=-(5) TabloRon [0,574540 446] 


l'aise 
[165,117)469,199] 














图 16-1 UIAutomatorViewer 界 面 








b 
全 % 右 上 角 的 树 状 菜单 那 是 相当 给 力 啊 ! 








右上 角 树 状 菜单 如 图 16-2 所 示 。 




















日 -(0) FrameLayout (0,01540,960] 
E- (0) LinearLayout [0,01540,960] 

日 .(0) FrameLayout [0,38][540,76] 
(0) TextView:bugben [6,39][S34,74] 

E (1) FrameLayout [0,76)540,960] F 

E- (0) TableLayout [0,76)(540,960] 再 也 没有 乱 
(0) TextView: 请 在 下 框 中 输入 希望 i ; ， 
E (1) TableRow [0,1171540,189] 码 的 困扰 了 
Qu TextView: 文本 框 1 文字 : ,134][164, 


日 (2) TableRow t 189540, 261] 
(0) TextView: YEERE : [0,206)164,239] 
(1) EditText:Bugben QQ: 1971629467 [164, 189.489, 261] 
(3) TextView: PRIS FS RAGE : [0,261540,302] 
E (4) TableRow [0,302Y540,374] 
(0) Text View: LH 18865, : [0,3021 164,335] 
E- (1) RadioGroup [164,302][489,374] 
E- (5) TableRow [0,374540,446] 





图 16-2 UIAutomatorViewer 界 面 右上 和 角 树 状 菜单 


E] 
PG FAME SE Bob esp o di 








右 下 角 的 丰富 信息 ， 如 图 16-3 所 示 。 








content-desc 
checkable 
checked 
clickable 
enabled 
focusable 
focused 
scrollable 


long-clickable 
password 
selected 
bounds 


1 

小 简洁 
android.widget.EditText 
com.xuben.hellobugben 


false 
false 
true 
true 
true 
true 
False 
true 
False 
false 
[164,117][489,189] 











图 16-3 UIAutomatorViewer 界 面 右 下 角 的 丰富 信息 








ee ne mi 那 为 什么 我 们 不 直接 基于 它 进 行政 造 ， 使 其 摇身一变 ， 成 为 一 款 PC 端 录制 回放 的 神器 呢 ? 

monkey AP A$ IE? 这 个 想法 好 大 胆 ， 让 人 激动 得 浑身 颤栗 ! 

QOL rnsako, Ji, A AKA GR AD EE RAP BPE X — dk dE EUR PCR UBI DALAL. KAP REMADE CA LARA E465, MEC LAE TAE RU! 
Oe, 我 对 自动 化 的 创意 很 恶心 ? 你 是 不 想 混 了 还 是 不 想 活 了 ? 

-全 奔 可 ， 我 也 觉得 很 好 玩 ， 要 不 咱们 玩 玩 吧 ， 至 少 能 学 到 一 些 技术 。 


9o... 既然 老板 认为 靠 谱 ， 小 伙伴 们 觉得 好 玩 ， 那 咱们 就 当 练 手 吧 ! 


162 ”基于 UIAutomatorViewer 的 PC 端 脚本 录制 工具 
16.2.1 PC 端 脚本 录制 工具 : 基本 设计 
既然 要 在 UIAutomatorViewer 基 础 上 进行 脚本 录制 的 改造 ， 那 么 我 们 就 需要 清楚 : 需要 新 增 哪些 功能 ? 
全 我 能 想到 的 就 是 ， 对 控件 操作 能 录 下 来 就 行 了 。 
eo 当然 不 行 ! 对 设备 的 其 他 命令 发 送 难道 不 需要 吗 ? 操作 不 需要 转换 为 对 应 脚本 吗 ? 脚本 基本 框架 不 需要 生成 吗 ? 
s» 
< 全 <% 呀 ， 你 一 说 还 真是 ， 但 我 脑袋 现在 一 片 混乱 ! 
eo... 一 定 要 把 握 住 大 方向 ， 然 后 逐步 细 化 。 大 方向 分 为 脚本 命令 、 脚 本 转换 和 结果 验证 3 个 方面 。 
E 
Sanh, AIL, RER? 


ey eta aH RIA LEGS. 


BS, 本 转换 又 分 为 UIAutomator 用 例 架 构 、 将 基本 操作 转换 为 UIAutomator 用 例 脚 本 和 将 其 他 命令 插入 到 UIAutomator 用 例 脚本 。 
-看 来 也 就 结果 验证 简单 了 。 


Bo, 每 一 步 又 继续 细 分 ， 如 下 。 


功能 需求 如 图 16-4 所 示 。 





UIAutomatorViewer 的 优势 

在 于 可 以 非常 精确 地 捕获 控件 ， 
并 获取 控件 的 丰富 信息 。 通 过 
这 些 信息 ， 我 们 可 以 非常 方便 
地 进行 控件 操控 ， 对 控件 的 基本 


| | 操作 与 黑 盒 测试 用 例 步骤 一 一 对 应 
yo BABS O 对 控件 的 基本 操作 C 


如 等 待 、 按 键 发 送 、 亮 屏 、 灭 屏 和 
截图 等 命令 ,看 似 与 测试 步骤 无 关 , 


但 对 于 可 独立 运行 的 脚本 而 言 ， 
这 些 操作 必 不 可 少 
对 设备 的 其 他 命令 O 
除了 将 控件 操作 转换 为 对 应 脚本 外 ， 
我 们 还 需要 构建 独立 可 运行 
的 UIAutomator 用 例 架构 
( 而 不 能 单单 是 几 个 操作 语句 ) 
UIAutomator 用 例 架 构 < 
当 用 户 在 PC 端 选择 某 个 操作 后 ( 如 
点 击 、 长 按 和 输入 等 ) ， 我 们 需要 将 
一 脚本 转换 “= 将 基本 操作 转换 为 ”其 转换 为 对 应 的 UIAutomator 脚 本 
UIAutomator 用 例 脚 本 
在 UIAutomator 用 例 脚 本 中 ， 在 基本 
操作 之 间 ， 需 要 将 用 户 希 望 的 命令 ( 如 
某 个 步骤 之 后 等 待 5 秒 ， 某 个 错误 之 后 截图 ， 
将 其 他 命令 插入 到 某 个 动作 之 后 灭 屏 等 ) 插入 用 例 步 又 中 
UIAutomator 用 例 脚本 | 





。 结果 验证 “| 已 -对 测试 步骤 的 结果 进行 验证 





图 16-4 ”功能 需求 
95. eras, 就 需要 考虑 对 应 的 功能 该 如 何 实现 。 
全 你 是 说 如 何 定位 控件 之 类 的 ? 还 是 你 总 结 吧 ! 


| Pere fe vee 控件 定位 、 右 键 菜单 、 脚 本 生成 、 脚 本 编辑 和 保存 。 具 体 设计 如 下 。 


功能 实现 设计 如 图 16-5 所 示 。 





" 当 鼠 标 在 页 面 上 移动 时 ， 会 获取 
e 控件 定位 。 'G” 每 个 控件 并 以 红 杠 形式 展现 ( 方便 
用 户 确认 当期 鼠标 对 应 控件 是 否 有 误 ) 


PC 端 用 户 的 习惯 是 ， 鼠 标 左 键 点 击 某 控件 
。 右键 菜单 "进行 控件 定位 ,定位 某 控件 后 ( 如 设置 ) ， 
鼠标 右键 弹出 操作 菜单 ( 符合 PC 端 用 户 的 使 用 习惯 ) 





当 用 户 选 择 某 个 操作 后 ， 在 右 侧 实 时 给 出 该 
脚本 生成 ”| 号 "操作 所 对 应 的 自动 生成 的 脚本 ( 即 该 操作 所 
转换 的 UIAutomator 用 例 脚 本 ) 





* 








脚本 编辑 、 保 存 “' 忆 “ 用 户 可 根据 需求 对 右 侧 脚 本 框 进行 手动 编辑 和 保存 











16-5 功能 实现 设计 





16.2.2 ”PC 端 脚本 录制 工具 : 详细 设计 


? 


立足 于 基本 设计 ， 让 我 们 一 起 更 深入 地 看 看 整个 架构 如 何 设计 。 


全 x 右键 菜单 应 该 具有 哪些 功能 呢 ? 





巴 哥 奔 认为 ， 至 少 应 具有 如 下 功能 (按照 实际 项 目 中 的 使 用 频率 进行 排序 ) 。 

1) Touch: 点 击 屏幕 。 

2) PressKey: 发 送 按键 信息 ,包括 <Back>、<Menu> 和 <Home> 键 。 

3) Long Touch: 长 按 功 能 。 

4) Scroll: 滑 屏 功能 (屏幕 滚动 ) 。 

5) Verify: 验证 功能 ， 具 体 指 查看 页 面 内 是 否 有 某 个 text 或 classname+instance。 


6) SnapShot: 截图 功能 。 





7) Screen: 包括 灭 屏 、 唤 醒 等 屏幕 操作 。 
8) Input: 输入 功能 ， 在 输入 框 内 写 入 内 容 。 
9) Sleep: 等 待 功能 ， 某 些 需 长 时 间 等 待 才能 出 现 的 页 面 ， 需 添加 sleep。 


详细 设计 如 图 16-6 所 示 。 






































先 来 看 看 touch (包括 long touch) ， 毫 无 疑问 ， 点 击 操作 是 用 户 最 、 最 …… (省 略 137 个 最 ) 常用 的 功能 ， 而 点 击 准确 与 否 直接 决定 整个 测试 脚本 的 稳定 性 和 可 用 性 。 















































859..4 点 击 的 关键 在 于 ， 对 控件 的 精确 定位 。 


全 A 那么， 我 们 如 何 对 控件 进行 定位 呢 ? 





* Sleep * 











16-6 详细 设计 





Touch 大 致 有 以 下 几 种 。 

1) Text: 通过 控件 文本 进行 定位 。 

2) Coordfinate: 通过 坐标 定位 ， 即 此 时 鼠标 在 界面 上 的 相对 位 置 。 

3) Class instance: 通过 控件 的 class+instance 进 行 定位 ， 即 控件 的 类 和 实例 进行 定位 。 
4) Resouce-ID: 通过 控件 的 Resouce id 进行 定位 ， 即 资源 文件 唯一 标识 符 。 


Touch 细 分 如 图 16-7 所 示 。 





再 来 看 看 PressKey 按 键 发 送 ， 很 简单 ， 如 下 。 


1) Back: 点 击 返 回 按钮 。 





2) Menu: 点 击 菜单 按钮 。 
3) Home: 点 击 主 页 面 按钮 。 


PressKey 细 分 如 图 16-8 所 示 。 





ut oy TTD 
3 i S d 更 
, 
e PressKey + ; x 
! 感 党 这 张 网 会 
4 
, 
e Long Touch *  / 
i FO RP St, 
` `M 
^ ` 
Verify * ^ ans . V 
'! 无 法 解脱 。 v 
^ H 
* Scroll + "ay Mo ^ 
`N ^ ge 
» c ` ^ 
Pa 7 ie. ul 
* SnapShot + t 4 
Pace’ 
1 b 
a>," 
* Screen + MJ 
* Input * 


Text 


. |... r Coordinate 
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图 16-7 Touch 细 分 


一 PressKey e 


图 16-8 PressKey 细 分 


而 长 按 (long touch) 和 验证 (verify) 说 白 了 也 是 对 控件 的 定位 ， 与 点 击 (touch) 保持 一 致 即 可 。 








Misawa, 验证 一 般 为 验证 控件 文本 ， 当 然 ， 也 有 验证 该 控件 所 在 位 置 的 ， 可 酌情 进行 增删 。 





Long touch 和 Verify 细 分 (与 touch 一 样 ) ， 如 图 16-9 所 示 。 











Text 
Coordinate 
e Long Touch © Verify 
Class instance 
Resouce-ID 


图 16-9 Long touch 和 Verify 细 分 














再 接 下 来 是 截图 SnapShot， 点 击 后 将 弹出 输入 框 ， 输 入 截图 名 字 即 可 ，SnapShot 细 分 如 图 16-10 所 示 。 

















Back 
Menu 
Home 


Text 
Coordinate 

- Class instance 
Resouce-ID 


e SnapShot - picture name 


图 16-10 ”SnapShot 细 分 


接 下 来 是 滚屏 Scroll， 分 为 上 、 下 、 左 、 右 四 个 方向 。 
- Up: 向 上 滑动 。 

: Down: 向 下 滑动 

| Left: 向 左 滑动 

“ Right: 向 右 滑动 。 


Scroll 细 分 如 图 16-11 所 示 。 





然后 是 针对 Screen 的 灭 屏 和 唤醒 ， 如 下 。 
: Screenof: 灭 屏 操作 。 


: Wakeup: 唤醒 操作 。 





Screen 细 分 如 图 16-12 所 示 。 





—-* Scroll © 


图 16-11 ”Scroll 细 分 





© | ~ p Screenoff 
——e Screen |C 
| Wakeup 





图 16-12 Screen 细 分 








再 接 下 来 是 输入 Input， 弹 出 文本 框 供用 户 输入 需要 的 文字 ， 如 图 16-13 所 示 。 








Sleep 既 可 提供 几 个 常用 暂停 时 间 供 用 户 选择 ， 也 可 让 用 户 输 入 暂停 时 间 (以 5 为 单位 ) ， 如 图 16-14 所 示 。 





一 一 Input © Inputbox 


图 16-13 ”Input 细 分 


~e Sleep 


~ seconds 
pe 














16-14 Sleep4a 4 
人 X% 下 面 ， 让 咱们 总 结 一 下 吧 ! 


详细 设计 总 结 如 图 16-15 所 示 。 
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e Touch - . 
Class instance 
Resouce-ID 
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* PressKey - Menu 
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Text 
Coordinate 
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Resouce-ID 
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| Resouce-ID 
| | | Up 
Il Down 
Il > I = 
I Sero Left 
I Right 
| / * SnapShot = Picture name 
{ / 
- Wakeup 
. Input - Inputbox 
* Sleep - Seconds 


图 16-15 详细 设计 总 结 
16.2.3 “PC 端 脚本 录制 工具 : 原理 剖析 


$9. s, 一 切 都 还 只 是 空 架 子 ， 要 想 按 需 进行 开发 ， 先 来 分 析 一 下 UIAutomator-Viewer 才 是 要 紧 。 
E c ， 不 过 从 哪 切 入 呢 ? 

B ii 就 需要 深入 了 解 两 个 方面 。 

其 一 ， 如 何 获取 控件 的 树 型 结构 ? 


其 二 ， 如 何 获取 控件 的 节点 属性 ? 


e» 
SK 那 咱们 先 来 看 看 如 何 获取 控件 的 树 型 结构 吧 ! 


Class instance 


这 张大 网 正在 
& deu 


| REPRE 


- - 
€—-— 


- 
Sonano” 


wa 


? 好 的 ， 这 又 分 为 3 个 问题 ! 


Se 需要 清楚 UIAutomatorViewet 是 如 何 解析 Xml 文件 并 生成 树 的 ? 
其 次 ， 解 析 View 树 后 ， 还 需 了 解 View 树 的 Root 节点 及 当前 节点 是 如 何 获取 的 ? 
第 三 ， 获 取 当 前 节点 还 不 够 ， 还 需 了 解 如 何 获取 当前 节点 的 父 节 点 和 子 节点 。 


UIAutomatorViewer 控 件 捕获 如 图 16-16 所 示 。 





如 何 解析 Xml 文件 并 生生 成 树 ? 
一 如 何 获取 控件 的 树 型 结构 ? © View 树 的 Root 节点 及 当前 节点 是 如 何 获取 ? 
如 何 获取 当前 节点 的 父 节点 和 子 节点 ? 





= _ TTE 
RRB UATE? “ 如何 获取 控件 属性 ? 


图 16-16 ”UIAutomatorViewer 控 件 捕获 


E 
全 % 听 得 我 一 个 头 两 个 大 ， 咱 们 一 个 一 个 分 析 吧 ! 


RO ， 首 先 我 们 一 起 来 看 看 UIAutomatorViewer 是 如 何 解 析 Xml 文 件 并 生成 树 的 。 


Bes sss 时 提 到 的 UIAutomator 吗 ? 


CKK RILAR, ARAE testing F m? 


之 前 分 析 源码 时 提 到 ，UIAutomator 在 “~\frameworks\testing\uiautomator\library\src\com\android\uiautomator” 目 录 下 ， 其 源码 树 如 图 16-17 所 示 。 





eo, 咱们 现在 要 用 到 的 UIAutomator 不 在 这 里 ， 而 在 uiautomatotviewer 下 面 。 


而 UIAutomatorViewer 位 于 : “~\sdk\uiautomatorviewer\src\com\android\uiautomator” 目录 下 ， 其 源码 树 如 图 16-18 所 示 。 





Accessibilit yNodeInfoDumper. java 
Accessibilit yNodeInfoHelper. java 
Interact ionController. java 
QueryController.java 

Tracer. java 
UiAutomatorBridge. java 
UiCollection. java 

UiDdDevice. java 

UiOhject.java 

Ui0bj ,ectNot FoundException. java 
UiScrollable.java 

UiSelector. java 

UiWatcher. java 





estrunner 
IAutomat ionSupport.java 
TestCaseCollector. java 
UiAutomatorTestCase. java 
UiAutomatorlestCaseFilter. java 
UiAutomatorTestRunner. java 





DebugBridge. java 
OpenDialog. java 
UiAutomatorHelper. java 
UiAutomatorModel. java 
UiAutomatorVview. java 
UiAutomatorV’iewer. java 


actions 
ExpandAllAction. java 
ImageHelper. java 
OpenFilesAction. java 
ScreenshotAct ion. java 
ToggleNafAction. java 





AttributePair. java 

Bas icTreeNode. java 

Bas icIreeNodeContent Provider. java 
RootWindowNode. java 
UiHierarchyamlLoader. java 

UiNode. java 


图 16-18 ”UIAutomatorViewer 源 码 树 
UIAutomator 解 析 工 具 既 可 执行 自动 化 脚本 (以 Jar 包 形式 ) ， 又 可 通过 dump 命 令 获 取 当 前 窗口 属性 ( 仅 当 前 页 面 可 见 部 分 ) ， 命 令 如 下 。 
adb shell UTAutomator dump dumpfile.xml 
打开 生成 的 dumpfile.xml， 如 代码 清单 16-1 所 示 。 


代码 清单 16-1 dumpfile.xml 


rollable-"false" 
ounds=" [0, 0] [108 


So 
人 看 不 懂 ， 奔 哥 解释 下 。 





eo. 首先 ，root 节 点 为 Hierarchy。 






六 哦 ， 那 接 下 来 Node 子 节点 是 不 是 对 应 view? 


eo, node 分 为 多 级 ， 分 别 代表 不 同 级 别 的 view。 每 级 view 中 的 index、text 和 class 都 是 该 view 对 应 的 属性 。 





Va T! 不 过 UIAutomator 又 是 如 何 解析 这 个 文件 的 呢 ? 


Sa 咱们 一 起 去 看 看 吧 ! 
解析 Xml 文件 并 生生 成 树 ， 源 码 地 址 为 : “~\sdk\uiautomatorviewer\src\com\android\uiautomator\tree\UiHierarchyXmlLoader\parseXml”， 如 代码 清单 16-2 所 示 。 


代码 清单 16-2 ”解析 Xml 文件 并 生生 成 树 





public BasicTreeNode parseXml(String xmlPath) { 


public void startElement (String uri, String localName, String qName, 

Attributes attributes) throws SAXException ( 

boolean nodeCreated - false; 

// xuben: 从 hierarchy 标 签 开 始 

mParentNode = mWorkingNode; 

if ("hierarchy".equals (qName)) ( 
mWorkingNode = new RootWindowNode (attributes .getValue ("windowName")); 
nodeCreated - true; 

// xuben: 到 node 标 签 ， 遍历 node 节 点 

} else if ("node".equals (gqName)) ( 
UiNode tmpNode = new UiNode(); 
for (int i = 0; i < attributes.getLength(); i++) { 

tmpNode.addAtrribute (attributes.getQName (i), attributes.getValue(i)); 
} 
mWorkingNode = tmpNode; 
nodeCreated = true; 
// xuben: 检查 当前 节点 是 否 为 NAF 
String naf = tmpNode.getAttribute ("NAF"); 
if ("true".equals(naf)) { 
mNafNodes.add(new Rectangle (tmpNode.x, tmpNode.y, 
tmpNode.width, tmpNode.height) ); 





SAMME T FR? 


82, ， 即 可 通过 View 树 获取 Root 节点 或 当前 节点 。 


通过 View 树 获取 Root 节点 或 当前 节点 ， 源 码 位 于 : “~\sdk\uiautomatorviewer\src\com\android\uiautomator\UIAutomatorModel” 目 录 下 ， 如 代码 清单 16-3 所 示 。 





代码 清单 16-3 ”获取 Root 节点 或 当前 节点 





// xuben: 获取 Root 节点 
public BasicTreeNode getXmlRootNode() ( 
return mRootNode; 


} 
// xuben: 获取 当前 选中 节点 
public BasicTreeNode getSelectedNode() { 
return mSelectedNode; 









哈哈， 这 样 一 来 ， 咱 们 就 可 以 在 代码 中 调用 这 两 个 方法 去 获取 Root 节 点 或 当前 选中 节点 了 ， 赞 一 个 ! 


获取 Root 节点 或 当前 选中 节点 示例 ， 如 代码 清单 16-4 所 示 。 


代码 清单 16-4 ”获取 Root 节点 或 当前 选中 节点 示例 





private static String doTouchOnViewByClassInstance (UIAutomatorModel mModel) ( 
String code - null; 
int instance - -1; 
ArrayList<BasicTreeNode> list = new ArrayList«BasicTreeNode»(); 
// xuben: 获取 Root 节点 
BasicTreeNode root = (BasicTreeNode) mModel.getXmlRootNode () ; 
// xuben: 获取 当前 选中 节点 
BasicTreeNode current = (BasicTreeNode) mModel.getSelectedNode () ; 








$9, 钛 ， 还 得 获取 父 节 点 / 子 节点 。 
获取 父 节点 / 子 节点 ， 源 码 位 于 : “~\sdk\uiautomatorviewer\src\com\android\uiautomator\tree\BasicTreeNod” 目录 下 ， 如 代码 清单 16-5 所 示 。 


代码 清单 16-5 ”获取 父 节点 / 子 节点 





// xuben: 获取 子 节点 
public List«BasicTreeNode» getChildrenList() ( 
return Collections.unmodifiableList (mChildren); 


l 
// xuben: 获取 子 节点 
public BasicTreeNode[] getChildren() ( 
return mChildren.toArray (CHILDREN TEMPLATE); 


// xuben: 获取 父 节点 
public BasicTreeNode getParent() ( 
return mParent; 


} 





Oa 获取 子 节点 为 列表 或 数组 形式 ， 因 为 可 能 存在 多 个 子 节点 。 


你 咽 ， 这 样 就 可 以 直接 获取 父 节点 / 子 节点 了 ! 
获取 父 节点 / 子 节点 示例 ， 如 代码 清单 16-6 所 示 。 


代码 清单 16-6 ”获取 父 节点 / 子 节点 示例 





// xuben: 遍历 以 root 为 根 节点 的 子 树 ， 并 将 结果 存在 列表 中 
private static void traverseTree (BasicTreeNode root, 
ArrayList<BasicTreeNode> list) { 
BasicTreeNode node = root; 
if ((node != null) && (node.toString() != null)) { 
list.add (node) ; 
} 
if (node.getChildCount() == 0) 
return; 
else ( 
BasicTreeNode[] childNodes = node.getChildren(); 
for (int i = 0; i < childNodes.length; i++) ( 
traverseTree (childNodes[i], list); 
} 





£e 

SGP AR, AMAA de TRE RBC! 

28 45, 这 分 为 两 个 问题 : 首先 ， 属 性 类 如 何 定义 ? 

其 次 ， 如 何 获取 控件 属性 ? 

获取 当前 View 节 点 属性 com.android.UIAutomator.tree， 如 代码 清单 16-7 所 示 。 


代码 清单 16-7 ”获取 当前 View 节 点 属性 





package com.android.UIAutomator.tree; 
public class AttributePair ( 
public String key, value; 
public AttributePair(String key, String value) ( 
// xuben: 这 里 的 Key， 就 是 指 属 性 标签 ， 如 text， index, class 
this.key = key; 
// xuben: 这 里 的 value， 即 对 应 属性 值 
this.value = value; 





Sok, PRRR BRI, TARH! 





获取 属性 代码 如 下 。 





AttributePair pair = (AttributePair) nodePairs[j]; 

if ("class".equals(pair.key) && className.equals (pair.value)) { 
list.add (node); 
break; 





96, 然 这 里 只 用 到 UIAutomatorViewer 中 关于 tree 的 代码 ， 但 还 是 有 必要 在 这 里 略微 总 结 一 下 。 


UIAutomatorViewer 分 类 总 结 如 图 16-19 所 示 。 





基于 SWT/JFACE 的 UI 代码 “= 





| actions © 用 户 操作 响应 代码 


获取 Root 接点 或 当前 节点 
获取 父 节点 / 子 节点 
获取 当前 View 节 点 属性 


tree -控件 树 形 结构 及 操作 O- 


| 
Y 


图 16-19 ”UIAutomatorViewer 分 类 总 结 
A 哈哈， 咱们 算是 国 满 完工 了 吧 ? 


Oigan, 咱们 还 得 分 析 一 下 如 何 构 建 录制 工具 的 核心 代码 。 


16.2.4 ”PC 端 脚本 录制 工具 : 界面 设计 


s, 咱们 从 哪里 开始 构建 呢 ? 


= 通过 eclipse 建 立 工 程 并 导入 相关 文件 ， 并 新 建 一 个 package。 





通过 eclipse 建 立 工程 并 导入 UIAutomatorviewer 相 关 文件 ， 如 图 16-20 所 示 。 


Java Build Path 


BÀ Libraries 


JARs and class folders on the build path: 


> |i androidjar - D:\eclipse\android-sdk-windows\platforms\anc 
> |f} com.bm.icu 4.4.2.v20110823 jar - D:\eclipse\plugins | 

b m ddmlib.jar - D:\eclipse\android-sdk-windows\tools\lib | 
> |f» javax.xml_1.3.4.v201005080400,jar - D:\eclipse\plugins | 


> |B org.eclipse.core.commands_3.6.0.120110111-0800,jar - D:\ec 


> |e org.eclipse.core.runtime_3.7.0.v20110110,jar - D:\eclipse\plu: | Add Library... j 

b lipse.core.runtime. ibility 3.2.100.v20100505.j 
DI rer 

> |G org.eclipse.equinox.common, 3.6.0.v20110523 jar - D:\eclipse 

> |i» org.eclipse.equinox.registry_3.5.101.R37x_v20110810-1611ja 


> |G org.eclipse.jface_3.7.0.v20110928-1505,jar - D:\eclipse\plugir 

> |f» org.eclipse.jface.databinding_1.5.0.120100907-0800,jar - D:\e Edit... 

> |G org.eclipse.jface.text_3.7.2.v20111213-1208,jar - D:\eclipse\p 

> (oo org.eclipse.osgi_3.7.2.v20120110-1415,jar - D:\eclipse\plugin 
> |i org.eclipse.osgi.util_3.2.200.v20110110,jar - D:\eclipse\plugir 

> Ge org.eclipse.swt.win32.win32.x86_3.7.2.v3740fjar - D:\eclipse\y Migrate JAR File... 

> |G org.eclipse.text_3.5.101.v20110928-1504.jar - D:\eclipse\plu 


> |e org.eclipse.ui.editors_3.7.0.v20110928-1504,jar - D:\eclipse\r 


> |f» uiautomator,jar - D:\eclipse\android-sdk-windows\platforms 


> BA JRE System Library [JavaSE-1.6] 

















16-20 ”导入 UIAutomatorviewer 相 关 文件 


$56,.. 进入 关键 代码 中 ， 首 先 要 分 析 的 是 UIAutomatorView。 
se 


人 嘿嘿， 哪些 地 方 可 以 动 刀 ? 
e. 们 首先 需要 添加 菜单 以 及 对 应 的 菜单 项 。 
编辑 UIAutomatorView， 添 加 菜单 及 相关 项 ， 如 代码 清单 16-8 所 示 。 


代码 清单 16-8 ”添加 菜单 及 相关 项 





// xuben: 添加 菜单 
private void createCanvasMenu() { 
mCanvasMenu = new Menu (mScreenshotCanvas); 
// xuben: 向 菜单 中 添加 子 项 Touch 
final MenuItem itemTouch = new MenuItem(mCanvasMenu, SWT.CASCADE); 
itemTouch.setText ("Touch") ; 
createCavansSubMenu (itemTouch, MENU TYPE TOUCH); 
// xuben: 向 菜单 中 添加 子 项 LongTouch 
final MenuItem itemLongTouch = new MenuItem(mCanvasMenu, SWT.CASCADE); 
itemLongTouch.setText ("Long Touch"); 
createCavansSubMenu (itemLongTouch, MENU TYPE LONGTOUCH); 
// xuben: 向 菜单 中 添加 子 项 Scrol1 
final MenuItem itemScroll = new MenuItem(mCanvasMenu, SWT.CASCADE); 
itemScroll.setText ("Scroll"); 
createCavansSubMenu (itemScroll, MENU TYPE SCROLL); 
// xuben: 向 菜单 中 添加 子 项 Verify 
final MenuItem itemVerify = new MenuItem(mCanvasMenu, SWT.CASCADE); 
itemVerify.setText ("Verify"); 
createCavansSubMenu (itemVerify, MENU TYPE VERIFY); 





E 
人 哈哈， 感觉 没 那么 难 ! 


$3, ,, 接 下 来 添加 子 菜单 ， 一 个 道理 。 








添加 子 菜单 ， 如 代码 清单 16-9 所 示 。 








代码 清单 16-9 添加 子 菜单 





// xuben: 添加 子 菜单 
private void createCavansSubMenu (MenuItem topItem, int type) { 
// xuben: 添加 子 菜单 
final Menu subMenu = new Menu (topItem) ; 
// xuben: 添加 子 菜单 项 Default 
final MenuItem subMenuItemDefault = new MenuItem(subMenu, SWT.POP UP); 
subMenuItemDefault.setText ("Default"); 
createCavansSubMenuListener (type, subMenuItemDefault) ; 
// xuben: 添加 子 菜 单项 Text 
final MenuItem subMenuItemByText = new MenuItem(subMenu, SWT.POP UP); 
subMenuItemByText.setText ("Text"); T 
createCavansSubMenuListener (type, subMenuItemByText) ; 
// xuben: 添加 子 菜单 项 Class Instance 
final MenuItem subMenuItemByClassInstance = new MenuItem(subMenu, 
SWT.POP UP); 
subMenuItemByClassInstance.setText ("Class Instance"); 
createCavansSubMenuListener (type, subMenuItemByClassInstance); 


topItem.setMenu (subMenu) ; 








SOK XI Jf 5| 69 3X 4e M vp vg S? 


eO, is, 自己 看 ! 


监听 createCavansSubMenuListener， 如 代码 清单 16-10 所 示 。 


代码 清单 16-10 监听 createCavansSubMenuListener 





private void createCavansSubMenuListener(final int type, final MenuItem item) { 
item.addListener(SWT.Selection, new Listener() ( 
public void handleEvent (Event e) ( 
String codeTemplateEnd = " }\n" + "}\n"; 
System.out.println (item.getText ()); 
String strInsert = mTextDocument.get (); 
striInsert = strInsert.substring(0, strInsert.length() 


- codeTemplateEnd.length() - 1); 
strInsert = strInsert + TestCaseGenerator.doTouchOnView (type, item, 
mModel); 


strInsert = strInsert + codeTemplateEnd; 
mTextDocument.set (strInsert); 





s» 
全 % 哦 ， 那 菜单 响应 代码 又 该 咋 写 呢 ? 


eo, 你 还 真是 凡事 必 问 啊 ! 








在 package 中 创建 类 ， 并 定义 菜单 响应 代码 ， 如 代码 清单 16-11 所 示 。 


代码 清单 16-11 定义 菜单 响应 代码 





// xuben: 定义 TouchViewByClassInstance 莱 单 处 理 程序 
private static String doTouchOnViewByClassInstance (UIAutomatorModel mModel) { 
String code - null; 
int instance - -1; 
ArrayList<BasicTreeNode> list = new ArrayList«BasicTreeNode»(); 
BasicTreeNode root = (BasicTreeNode) mModel.getXmlRootNode () ; 
BasicTreeNode current = (BasicTreeNode) mModel.getSelectedNode () ; 
traverseTree (root, list); 
System.out.println (list.size ()); 
String text = ""; 
String className = ""; 
// xuben: Instance 获取 
list = getViewsByClassName (root, getNodeAttr("class", mModel)); 
for (int i = 0; i < list.size(); i++) { 
text = getNodeAttr ("text", list.get(i)); 
className = getNodeAttr("class", list.get(i)); 
if (current.hashCode() == list.get(i).hashCode()) { 
System.out.println("Instance: " + i + "--Text: " + text 
+ "—-class: " + className); 
instance = 
break; 











} 


» 
// xuben: 测试 代码 生成 
code = "!mUiTestBase.touchOnViewByClassInstance" + "(" + "A"" 
+ className.trim() + "\"" +", " + instance + ")" +") {\n"; 
code = code + TAB + TAB + TAB 
+ "System.out.println(V'Touch on View fail 
+ instance + ", classname-" + className + " 
code = opsHead + code + opsEnd; 
return code; 





instance=" 
")e\n"; 











16.3 UlAutomatorViewersl| T ERA 


> 感觉 ? 


哈哈， 感觉 比 monkey 录 制 工具 强大 多 了 1! 


Ora 本 来 就 不 具有 可 比 性 ， 基 于 不 同 的 平台 和 代码 ， 怎 么 比 ? 
而 且 一 个 是 轻 量 级 的 ， 一 个 是 重量 级 的 ， 用 途 也 不 同 。 

06... 当初 我 让 你 们 做 这 个 没 错 吧 ? 效率 大 大 提升 。 
9o... 你 说 提升 就 提升 吧 ， 至 少 我 不 这 么 看 …… 

V Cu? 你 说 什么 ? 
ROn, 我 的 意思 是 我 个 人 更 喜欢 简单 实用 的 工具 。 

UIAutomatorViewer 作 为 控件 抓 取 工具 已 经 非常 完美 ， 用 它 来 录制 不 是 不 行 ， 但 实际 效率 肯定 不 如 直接 使 用 。 


Ls 开发 了 这 么 久 ， 效 率 反而 降低 了 ? 


ST 我 只 能 说 ， 门 槛 的 确 降 低 了 ， 直 接 录 制 使 得 更 多 的 黑金 测试 人 员 也 能 用 。 


D 


ta È AA monkeyi3k Hp HEE RALPH, EURIEK. BRAA, RARER AÈ EA E e MUN TARAMA. 
Sa 

SRF, KARAT RM? 

$59. -200, 而 是 要 正确 地 认识 所 有 工具 的 价值 所 在 ， 我 们 要 的 不 是 改造 的 过 程 ， 而 是 要 真正 创造 价值 ， 提 高 效率 。 

OO nen, 我 跟 大 BOSS 汇 报 咱们 这 次 重大 改进 还 是 得 到 好 评 ， 并 拿 到 嘉奖 。 既 然 你 这 么 不 认可 ， 看 来 嘉奖 还 是 给 别人 的 好 。 
85... 建议 这 类 改造 还 是 越 少 越 好 吧 ! 


OF ras 





第 17 章 ”从 CTS 到 定制 化 单元 测试 


ke 所作 为 兼容 性 测 试 的 标准 ， 谷 歌 公 司 自然 会 不 断 改进 CTS。 在 具体 项 目 中 ， 我 们 更 需 定制 化 地 用 好 这 个 单元 测试 框架 ! 


171 ”从 CTS 原 理 说 开 来 


OO ,easnnra, 不 过 再 给 你 一 次 将 功 赎罪 的 机 会 研发 部 门 希望 咱们 能 开发 一 个 单元 测试 框架 ， 用 来 测试 项 目 中 对 某 些 接口 的 修改 。 
E] 

CUR, ROLOGRESAERAR, KT RHE! 

eo... 干 嘛 要 重新 开发 单元 测试 框架 ， 这 里 不 是 有 现成 的 吗 ? 

EC] 

人 咱们 有 现成 的 ? 我 咋 不 知道 ? 难道 学 漏 了 ? 


$9... CTS 就 是 最 好 的 单元 测试 框架 啊 ! 咱们 根据 项 目 需求 继续 往 里 面 添加 用 例 就 可 以 了 。 

















从 事 Android 测 试 和 研发 的 小 伙伴 们 应 该 没有 不 知道 CTS 测 试 的 ， 对 于 负责 兼容 性 测试 的 小 伙伴 更 是 日 复 一 日 地 反复 运行 CTS 一 一 批量 运行 、 计 划 运 行 、 单 包 运 行 、 单 用 例 运行 … 而 所 有 因为 CTS 运 行 
反复 发 现 自己 代码 中 的 bug 的 小 伙伴 们 更 是 与 CTS 苦 苦 纠缠 、 游 斗 不 止 。 
































9o, .. 有 没有 人 认真 想 过 : 对 于 实际 项 目 而 言 ，CTS 测 试 集 真 的 完备 吗 ? 如 果 不 完备 我 们 该 做 些 什么 ? 
每 当 巴 哥 奔 提出 这 个 问题 时 ， 得 到 的 答案 往往 是 这 样 的 .……… 

ye 资深 工程 师 们 开发 的 ， 难 道 你 比 他 们 还 牛 ? 

CTS 已 经 够 烦人 了 ， 难 道 你 还 想 更 烦人 ? 


CTS 不 过 就 是 一 个 基础 性 的 测试 ， 你 还 想 玩 出 什么 花样 来 ? 

OO coss CTS 本 身 发 现 的 bug 我 肯定 会 解决 ,但 除 此 之 外 ， 通 过 CTS 框 架 运行 你 的 用 例 发 现 的 bug， 不 好 意思 ， 没 时 间 搭 理 你 ! 
别 作秀 了 ， 做 点 实在 的 工作 吧 ! 

9© .eaazsase 


巴 哥 奔 认 为 不 需要 ， 因 为 问题 本 身 已 经 暴露 出 发 癌 人 的 无 知 、 傲 慢 与 懒惰 。 





ss 那么 ， 我 们 究竟 为 什么 要 利用 CTS 框 架 定制 单元 测试 脚本 呢 ? 


$9, iss. 理由 如 下 。 





利用 CTS 框 架 定制 单元 测试 脚本 理由 如 图 17-1 所 示 。 





” 当 项 目 组 根据 需要 增加 某 些 接口 时 “需要 针对 新 增 接口 进行 测试 








| 当 CTS 尚 未 针对 核心 接口 设计 测试 用 例 时 “需要 针对 核心 接口 新 增 测试 用 例 





当 项 目 组 新 增 或 修改 某 个 功能 使 得 某 个 接口 一 需要 增加 测试 的 深度 
变 得 异常 关键 ， 而 CTS 现 有 用 例 的 测试 深度 不 够 时 

















， 当 某 个 接口 调用 频繁 出 错时 < 需要 对 其 进行 有 针对 性 的 测试 
| “ 当 很 多 bug 都 指向 某 个 接口 时 、 - 
( bug 永 远 都 是 表象 ， 而 很 多 局- 需 要 针对 该 bug 设 计 接口 测试 
bug 最 终 的 根源 可 能 都 是 一 个 ) 


| 当 菜 些 接口 因为 bug 改 动 时 | 需要 对 这 些 接口 进行 验收 测试 


图 17-1 CTS 框架 定制 单元 测试 脚本 理由 


172 ”用 CTS 运 行 定制 单元 测试 脚本 


E 
SAF KAM: 我 们 该 如 何 利用 CTS 这 套 框 架 进行 更 有 针对 性 、 更 全 面 的 测试 呢 ? 


BO yew 


巴 哥 奔 的 方案 如 图 17-2 所 示 。 





根据 测试 中 的 需求 ， 结 合 CTS 测 试用 例 
| 项 目 需求 分 析 — 现状， 分析 是 否 需 要 添加 CTS 用 例 


| 研究 官方 相关 的 CTS 用 全 ， 
— CTS /不 仅 可 以 从 中 学 到 很 多 单元 测试 用 例 的 设计 方法 ， 
研究 官方 CTS 用 例 集 “更 帮助 我 们 发 现 CTS 还 有 哪些 不 中 


如 果 需 要 添加 自 定义 用 例 , 
| Y 局“ 大 家 需要 了 解 如 何 才能 将 你 设计 
EUN ”的 用 例 添 加 到 CTS 测 试 框架 中 





| 运行 自 定义 CTS 用 例 集 | 局 “运行 自 定义 CTS 测 试用 例 ， 检 验 测试 结果 


图 17-2 CTS 自 定义 测试 方案 
BE. 让 我 们 一 起 来 研究 一 下 CTS 用 例 集 ! 


17.2.1 项 目 需求 分 析 


OS. cane 门 对 蓝牙 搜索 和 取消 搜索 这 两 块 的 API 进 行 了 修改 ， 需 要 进行 单元 测试 验证 ! 





， 第 一 步 咱们 先 干 嘛 ? 





， 查 一 下 CTS 有 没有 针对 蓝牙 搜索 和 取消 搜索 的 测试 用 例 。 


5 
全 % 如 果 有 该 怎么 办 ? 没有 又 该 怎么 办 ? 


9o, ex, 那 咱们 就 得 看 看 和 咱们 项 目 实际 需求 匹配 度 如 何 ， 测 试 深度 是 否 足够 ， 是 否 需要 新 增 用 例 。 如 果 没 有 ， 就 看 看 有 没有 相关 用 例 以 供 参 考 。 






AT i, NUN! 那 咱们 下 一 步 是 不 是 直接 在 源 文件 中 添加 或 修改 ? 
> ru 


什么 呢 ? 





S5, saceostsanesamann, 如 果 我 们 擅自 对 这 些 原始 用 例 进 行 增 、 删 、 改 ， 将 直接 影响 到 CTS 本 身 的 测试 有 效 性 。 





Se 
SAET! 那 咱们 拷贝 出 来 改 吧 ! 


$96, xx, 让 咱们 先 看 看 官方 提供 的 蓝牙 相关 的 CTS 用 例 吧 ! 


17.2.2 ”研究 官方 CTS 用 例 集 





他 % 奔 哥 ， 到 哪里 找 蓝 牙 相关 的 CTS 用 例 ? 


QO ecra 例 都 在 “~/cts/tests/tests” 源 码 下 。 





找到 了 bluetooth 文 件 夹 。 


eo. 那 咱 们 就 别 偷懒 了 ， 一 起 分 析 一 下 吧 ! 





























首先 ， 在 “~/cts/tests/tests” 源 码 下 搜索 blutooth 相 关 测试 用 例 集 ， 我 们 找到 针对 蓝牙 的 CTS 单 元 测试 用 例 
为 : = "~/cts/tests/tests/bluetooth/src/android/bluetooth/cts/BasicAdapterTest.java” 。 











打开 该 用 例 集 ， 不 是 特别 复杂 ， 我 们 一 起 来 分 析 一 下 ， 如 代码 清单 17-1 所 示 。 








代码 清单 17-1 BasicAdapterTest.java 





Copyright (C) 2009 The Android Open Source Project 


Licensed under the Apache License, Version 2.0 (the "License"); 
you may not use this file except in compliance with the License. 
You may obtain a copy of the License at 


http: //www.apache.org/licenses/LICENSE-2.0 


Unless required by applicable law or agreed to in writing, software 
distributed under the License is distributed on an "AS IS" BASIS, 
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
See the License for the specific language governing permissions and 

* limitations under the License. 


package android.bluetooth.cts; 
import android.bluetooth.BluetoothAdapter; 
import android.bluetooth.BluetoothDevice; 
import android.bluetooth.BluetoothServerSocket; 
import android.content.pm.PackageManager; 
import android.test.AndroidTestCase; 
import java.io.IOException; 
import java.util.Set; 
import java.util.UUID; 
ger 
* Very basic test, just of the static methods of {@link 
* BluetoothAdapter}. 
* 
/ 
public class BasicAdapterTest extends AndroidTestCase { 
private static final int DISABLE TIMEOUT = 8000; // ms timeout for BT disable 
private static final int ENABLE TIMEOUT = 10000; // ms timeout for BT enable 
private static final int POLL TIME = 400; // ms to poll BT state 
private static final int CHECK WAIT TIME = 1000; // ms to wait before enable/disable 
private boolean mHasBluetooth; € 
public void setUp() throws Exception ( 
super.setUp(); 
// xuben: 获取 蓝牙 包 名 "android.hardware.bluetooth" 字 串 
mHasBluetooth = getContext () .getPackageManager () .hasSystemFeature ( 
PackageManager.FEATURE BLUETOOTH); 
l 
// xuben: 测试 是 否 支持 蓝牙 设备 
public void test getDefaultAdapter() { 
/* 


* Note: If the target doesn't support Bluetooth at all, then 
* this method should return null. 
* 
/ 
if (mHasBluetooth) ( 
assertNotNull (BluetoothAdapter.getDefaultAdapter () ); 
} else { 
assertNull (BluetoothAdapter.getDefaultAdapter () ); 
; } 
// xuben: 测试 蓝牙 地 址 是 否 正确 ， 类 似 "12:34:56:78:9RA:BC" 
public void test checkBluetoothAddress() ( 
// xuben: 首先 检查 蓝牙 地 址 不 能 为 空 
assertFalse (BluetoothAdapter.checkBluetoothAddress (null)); 
// xuben: 其 次 检查 蓝牙 地 址 长 度 必须 为 17 字 节 
assertFalse (BluetoothAdapter.checkBluetoothAddress ("") 
assertFalse (BluetoothAdapter.checkBluetoothAddress 
assertFalse (BluetoothAdapter.checkBluetoothAddress 
assertFalse (BluetoothAdapter.checkBluetoothAddress 
assertFalse (BluetoothAdapter.checkBluetoothAddress 
assertFalse (BluetoothAdapter.checkBluetoothAddress 





(" 
(" 
(" 
(" 


assertFalse (BluetoothAdapter. 
assertFalse (BluetoothAdapter. 
assertFalse (BluetoothAdapter. 
assertFalse (BluetoothAdapter. 
assertFalse (BluetoothAdapter. 
assertFalse (BluetoothAdapter. 
assertFalse (BluetoothAdapter. 
assertFalse (BluetoothAdapter. 
assertFalse (BluetoothAdapter. 
assertFalse (BluetoothAdapter. 
assertFalse (BluetoothAdapter. 


checkBluetoothAddress ("00: 
checkBluetoothAddress ("00 
checkBluetoothAddress ("00 
checkBluetoothAddress ("00 
checkBluetoothAddress ("00 

( 

( 

( 











checkBluetoothAddress ("00 
checkBluetoothAddress ("00: 
checkBluetoothAddress ("00: 
checkBluetoothAddress 
checkBluetoothAddress ("00: 
checkBluetoothAddress ( 


"00:00:00:00:00:0")); 

// xuben: 蓝牙 地 址 八 位 字 节 之 间 必 须 为 冒号 间隔 

assertFalse (BluetoothAdapter.checkBluetoothAddress ( 
"00x00:00:00:00:00")); 

assertFalse (BluetoothAdapter.checkBluetoothAddress ( 
"00:00.00:00:00:00")) ; 

assertFalse (BluetoothAdapter.checkBluetoothAddress ( 
"00:00:00-00:00:00")) ; 

assertFalse (BluetoothAdapter.checkBluetoothAddress ( 
"00:00:00:00900:00")); 

assertFalse (BluetoothAdapter.checkBluetoothAddress ( 
"00:00:00:00:0000")) ; 

// xuben: 蓝牙 地 址 字 节 中 字母 必须 为 大 写 

assertFalse (BluetoothAdapter.checkBluetoothAddress ( 
"a0:00:00:00:00:00")); 

assertFalse (BluetoothAdapter.checkBluetoothAddress ( 
"0b:00:00:00:00:00")); 

assertFalse (BluetoothAdapter.checkBluetoothAddress ( 
"00:c0:00:00:00:00")) ; 

assertFalse (BluetoothAdapter.checkBluetoothAddress ( 
"00:0d:00:00:00:00")); 

assertFalse (BluetoothAdapter.checkBluetoothAddress ( 
"00:00:e0:00:00:00")); 

assertFalse (BluetoothAdapter.checkBluetoothAddress ( 
"00:00:0£:00:00:00")); 

assertTrue (BluetoothAdapter.checkBluetoothAddress ( 
"00:00:00:00:00:00")) ; 

assertTrue (BluetoothAdapter.checkBluetoothAddress ( 
"12:34:56:78:9A:BC")); 

assertTrue (BluetoothAdapter.checkBluetoothAddress ( 
"DE:F0O:FE:DC:B8:76")); 


l 
// xuben: 测试 反复 开关 蓝牙 5 次 
/** Checks enable(), disable(), getState(), isEnabled() */ 
public void test enableDisable() ( 
if (!mHasBluetooth) { 
// Skip the test if bluetooth is not present. 
return; 


} 

BluetoothAdapter adapter 
for (int i=0; i«5; i++) { 
disable (adapter); 
enable (adapter); 


BluetoothAdapter.getDefaultAdapter () ; 


} 


} 
// xuben: 测试 本 机 蓝牙 地 址 格式 是 否 正确 
public void test getAddress() { 
if (!mHasBluetooth) { 
// Skip the test if bluetooth is not present. 
return; 
} 
BluetoothAdapter adapter 
enable (adapter); 
assertTrue (BluetoothAdapter.checkBluetoothAddress (adapter.getAddress ())); 
} 
// xuben: 测试 本 机 蓝牙 名 是 否 正 确 
Public void test getName() { 
if (!mHasBluetooth) { 
// Skip the test if bluetooth is not present. 
return; 


BluetoothAdapter.getDefaultAdapter () 7 


} 

BluetoothAdapter adapter 
enable (adapter) ; 

String name = adapter.getName () ; 
assertNotNull (name) ; 


BluetoothAdapter.getDefaultAdapter () 7 


} 
// xuben: 测试 匹配 本 机 的 蓝牙 地 址 格式 是 否 正确 
public void test getBondedDevices() { 
if (!mHasBluetooth) { 
// Skip the test if bluetooth is not present. 
return; 
l 
BluetoothAdapter adapter 
enable (adapter); 
Set«BluetoothDevice» devices 
assertNotNull (devices); 
for (BluetoothDevice device : devices) ( 
assertTrue (BluetoothAdapter.checkBluetoothAddress (device.getAddress ())); 


BluetoothAdapter.getDefaultAdapter () ; 


adapter .getBondedDevices () ; 


} 


l 
// xuben: 通过 蓝牙 地 址 匹配 该 蓝牙 对 象 
public void test getRemoteDevice() ( 
if (!mHasBluetooth) ( 
// Skip the test if bluetooth is not present. 
return; 


l 
// getRemoteDevice() should work even with Bluetooth disabled 
BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter (); 
disable (adapter); 
// xuben: 错误 蓝牙 地 址 测试 
try { 
adapter.getRemoteDevice ( (String) null); 
fail ("IllegalArgumentException not thrown"); 
} catch (IllegalArgumentException e) {} 
try { 
Adapter gecktenotebevice ("00:00:00:00:00:00:00:00") ; 
fail("IllegalArgumentException not thrown"); 
} catch (IllegalArgumentException e) {} 
try { 
adapter.getRemoteDevice ( (byte[]) null); 
fail ("IllegalArgumentException not thrown"); 
} catch (IllegalArgumentException e) {} 
try i 
: adapter.getRemoteDevice (new byte[] (0x00, 0x00, 0x00, 0x00, 0x00}); 
fail("IllegalArgumentException not thrown"); 
} catch (IllegalArgumentException e) {} 
// test success 
BluetoothDevice device 
assertNotNull (device); 
assertEquals ("00:11:22:AA:BB:CC", device.getAddress ()); 
device adapter .getRemoteDevice ( 
new byte[] {0x01, 0x02, 0x03, 0x04, 0x05, 0x06}); 
assertNotNull (device); 
assertEquals ("01:02:03:04:05:06", device.getAddress ()); 


l 
// xuben: 创建 一 个 正在 监听 的 无 线 射频 通信 蓝牙 端口 
public void test listenUsingRfcommWithServiceRecord() throws IOException { 
if (!mHasBluetooth) { 
// Skip the test if bluetooth is not present. 
return; 


adapter.getRemoteDevice ("00:11:22:AA:BB:CC"); 


} 

BluetoothAdapter adapter 

enable (adapter); 

BluetoothServerSocket socket = adapter.listenUsingRfcommWithServiceRecord ( 
"test", UUID.randomUUID()); 

assertNotNull (socket) ; 

Socket .close () 7 


BluetoothAdapter.getDefaultAdapter () 7 


// xuben: 若 蓝牙 开启 则 将 其 关闭 
private void disable (BluetoothAdapter adapter) { 
Sleep(CHECK WAIT TIME); 


3f (adapter.getState () = BluetoothAdapter.STATE Of) { 
assertFalse (adapter.isEnabled()); 
return; 


} 
assertEquals (BluetoothAdapter.STATE ON, adapter.getState()); 


assertTrue (adapter. isEnabled()); 
adapter.disable(); 
boolean turnOf - false; 
for (int i=0; i«DISABLE TIMEOUT/POLL TIME; i++) { 
sleep(POLL TIME); 
int state = adapter.getState(); 
switch (state) ( 
case BluetoothAdapter.STATE Of: 
assertFalse (adapter.isEnabled()); 
return; 
default: 
if (state != BluetoothAdapter.STATE ON || turnOf) ( 
assertEquals (BluetoothAdapter.STATE TURNING Of, state); 
turnOf = true; 
} 
break; 


l 

fail("disable() timeout"); 
} 
// xuben: 若 蓝牙 关闭 则 将 其 开启 


private void enable (BluetoothAdapter adapter) { 
sleep (CHECK_WAIT TIME); 


if (adapter.getState() == BluetoothAdapter.STATE ON) { 
assertTrue (adapter.isEnabled()); 
return; 


} 
assertEquals (BluetoothAdapter.STATE Of, adapter.getState()); 


assertFalse (adapter. isEnabled()); 
adapter.enable(); 
boolean turnOn - false; 
for (int i-0; i«ENABLE TIMEOUT/POLL TIME; i++) ( 
sleep (POLL TIME); ` ~ 
int state = adapter.getState(); 
switch (state) { 
case BluetoothAdapter.STATE ON: 
assertTrue (adapter.isEnabled()); 
return; 
default: 
if (state != BluetoothAdapter.STATE Of || turnOn) { 
assertEquals (BluetoothAdapter.STATE TURNING ON, state); 
turnOn - true; Di T 
} 
break; 
} 


} 
fail ("enable() timeout"); 
} 
private static void sleep(long t) { 
try { 
Thread.sleep(t); 
} catch (InterruptedException e) {} 








WHERE, KART! 


| ee 希望 大 家 认真 学 习 几 遍 ， 对 未 来 编写 单元 测试 用 例 大 有 神 益 ! 





CTS 4.2 蓝 牙 测试 (确切 地 说 是 BasicAdapterTest) 的 测 斌 用例、 解释 和 对 应 APl 整 理 如 








图 17-3 所 示 。 








得 到 蓝牙 包 名 


“android.hardwar 
e.bluetooth ” FÈ 中 存 有 蓝牙 的 包 名 


API: getDefaultAdapter(), 
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API: enable(), 
listenUsingRfcommWithSer 
viceRecord() 


图 17-3 BasicAdapterTest.& 24 


est_listenUsing 
RfcommWithSer 
iceRecord 
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Vom. Bot Hdk— A ERRARE 


| 


eo... 从 图 中 很 清晰 地 发 现 ，CTS 中 的 确 没有 针对 蓝牙 搜索 的 测试 。 
fo 
KAR ve Ai de AT VE? 


2 首先 ， 咱 们 需要 了 解 蓝牙 搜索 所 涉及 的 API 都 有 哪些 。 


17.2.3 自 定 义 CTs 用 例 集 





D 





到 17-4 所 示 。 








在 Android 官 网 (http://developer.android.com) 上 搜索 该 模块 API， 这 里 搜索 “Bluetooth”。 找 到 android.bluetooth ， 找 到 它 有 哪些 类 (class) , w 





an2»a30i» 


d eve | 0 p e [S search developer dos — 


SDK Dev Guide Resources Videos E] Filter by API Level: | 


android.app 
android.app.admin 
android.app.backup 
android.appwidget 
android.bluetooth 
android.content BluetoothA2dp This class provides the public APIs to control the Bluetooth A2DP profile. 
android.content.pm 

android.content.res BluetoothAdapter Represents the local device Bluetooth adapter. 

android.database | 
android.database.sqlite | 
android.drm BluetoothClass Represents a Bluetooth class, which describes general characteristics and capabilities of a device. 
android.gesture | 

android.graphics BluetoothClass.Device Defines all device class constants. 

android.graphics.drawable | 
android.graphics.drawable.shapes 





Classes 


BluetoothAssignedNumbers Bluetooth Assigned Numbers. 





BluetoothClass.Device.Major Defines all major device class constants. 





BluetoothClass.Service Defines all service class constants. 
Interfaces 


BluetoothProfile | 
BluetoothProfile. ServiceListener BluetoothHeadset Public API for controlling the Bluetooth Headset Service. 


BluetoothDevice Represents a remote Bluetooth device. 


Classes BluetoothServerSocket A listening Bluetooth socket. 


BluetoothA2dp BluetoothSocket A connected or connecting Bluetooth socket. 





图 17-4 搜索 模块 API 


点 击 某 个 class， 找 到 它 的 Public Methods (公共 方法 ) ， 这 些 公 共 方 法 就 是 bluetooth 的 AP1， 如 图 17-5 所 示 。 





Qn230ID 


d eve | o p e fS search developer docs 


Dev Guide Reference Resources Videos 回 Fiter by API Level 


Public Methods 


android.app boolean cancelDiscovery () 
android.app.admin Cancel the current device discovery process. 


android.app.backup 
android appwidget static boolean checkBluetoothAddress (String address) 


android.bluetooth Validate a Bluetooth address, such as "00:43:A8:23:10:F0" 
android.content Alphabetic characters must be uppercase to be valid. 


android.content.pm _ u 

android.content.res void | closeProfileProxy (int profile, BluetoothProfile proxy) 

android.database Close the connection of the profile proxy to the Service. 

android.database.sqlite 

android.drm boolean | disable() 

android.gesture Turn off the local Bluetooth adapter—do not use without explicit user action to turn off Bluetooth. 
android.graphics 
android.graphics.drawable 
android.qraphics.drawable.shapes 


BluetoothClass String getAddress () 

BluetoothClass.Device Returns the hardware address of the local Bluetooth adapter. 
BluetoothClass.Device.Major 
BluetoothClass.Service 
BluetoothDevice 
BluetoothHeadset 
BluetoothServerSocket 
BluetoothSocket 





boolean enable () 
Turn on the local Bluetooth adapter—do not use without explicit user action to turn on Bluetooth. 





Set<BluetoothDevice> | getBondedDevices () 
Return the set of BluetoothDevice objects that are bonded (paired) to the local adapter. 





synchronized static BluetoothAdapter getDefaultAdapter () 
Get a handle to the default local Bluetooth adapter. 


String | getName () 





117-5 bluetooth#4 API 


E 
SARAT! 蓝牙 搜索 相关 API 包 括 “ 开 始 搜索 ”、“ 取 消 搜索 ”， 以 及 “判断 是 否 正在 搜索 ”3 个 方法 。 





蓝牙 搜索 相关 的 AP 为: startDiscovery0、cancelDiscovery0， 以 及 判断 是 否 正 在 搜索 的 isDiscoverfing03 个 方法 。 
全 <%3 个 方法 还 好 ， 未 来 如 果 我 随时 需要 查看 哪些 API 被 CTS 履 盖 ， 哪 些 没有 ， 该 怎么 办 ? 


99, ics. 可 以 将 所 有 Public Methods 统 计 到 表 里 ， 并 对 照 CTS 测 试用 例 与 项 目 需 要 进行 跟踪 。 











CTS 测 试用 例 覆 盖 APl 与 项 目 需要 对 照 表 ， 如 图 17-6 所 示 。 














B | C E F 
Num |Public Methods CTS | 解决 方案 /状态 


x? 
.2 |BluetoothA cancelDiscovery() r | 添加 该 用 例 
3 dapter Cancel the current device discovery process. 


static boolean checkBluetoothAddress(String address 
Validate a Bluetooth address, such as "00:43:A8:23:10:FO"Alphabetic characters must be uppercase to be 
valid. 


closeProfileProxy(int profile, BluetoothProfile pro: 
Close the connection of the profile proxy to the Service. 
[T- es 
urn off the local Bluetooth adapter—do not use without explicit user action to turn off Bluetooth. 
pue e 
urn on the local Bluetooth adapter—do not use without explicit user action to turn on Bluetooth. 
pre um 
Returns the hardware address of the local Bluetooth adapter. 
getBondedDevices 
e» Return the set of BluetoothDevice objects that are bonded (paired) to the local adapter. 
| oea getDefaultAdapter() 
BluetoothAdapter |Get a handle to the default local Bluetooth adapter. 


Get the friendly Bluetooth name of the local Bluetooth adapter. 





图 17-6 CTS) iXJ8 61 APIS SR E GRR 
人 到 了 最 关键 的 时 刻 ， 我 们 该 如 何 添加 用 例 ? 


GO a suman, 拷贝 一 份 CTS 用 例 集 出 来 ， 并 在 拷贝 的 CTS 测 试 目录 中 添加 咱们 的 测试 用 例 集 。 











这 里 针对 蓝牙 的 CTS 单 元 测试 用 例 为 : "~/cts/tests/tests/bluetooth/src/android/bluetooth/cts/BasicAdapterTest.java” . 























我 们 绝 不 能 直接 修改 BasicAdapterTestjava 这 个 文件 ， 而 应 该 在 “~/cts/tests/tests” 测 试 目录 中 添加 “bluetooth_More” 目 录 ， 表 示 其 为 我 们 的 新 增 目录 (具体 命名 可 根据 项 目 进行 命名 ) 。 并 在 
KBR FEW "-/src/android/bluetooth More/cts/BasicAdapterTest More.java" 文件， 完整 的 路 径 
为 : "—^/cts/tests/tests/bluetooth More/src/android/bluetooth More/cts/BasicAdapterTest More.java" 。 


全 建立 专属 测试 用 例 集 后 ， 我 们 是 不 是 就 可 以 将 所 需 测 试 写 到 该 用 例 集 了 ? 


Ora, 新 用 例 集 结构 大 致 与 原始 用 例 集 保持 一 致 ， 这 里 为 了 节省 空间 ， 仅 提供 添加 的 两 个 用 例 。 
用 例 1: 蓝牙 搜索 用 例 ， 如 代码 清单 17-2 所 示 。 


代码 清单 17-2 ”蓝牙 搜索 用 例 





/**Add More case: startDiscovery() 
* start discovery 
* Author xuben 
xf 


public void test startDiscovery() { 
if (!mHasBluetooth) { 
//skip the test if bluetooth is not present. 
return; 
$ 
BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter(); 
enable (adapter) ; 
// xuben: 调用 启动 搜索 方法 ， 并 检验 是 否 返 回 正确 
assertTrue (adapter.startDiscovery()); 





用 例 2: 蓝牙 取消 搜索 用 例 ， 如 代码 清单 17-3 所 示 。 


代码 清单 17-3 ”蓝牙 取消 搜索 用 例 





/**Add More case: isDiscovering(), cancelDiscovery () 
* if is discovering, cancel discovery 

* Author xuben 

*/ 


public void test isDiscovering cancelDiscovery() ( 
if (!mHasBluetooth) { 
//skip the test if bluetooth is not present. 
return; 
l 
BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter (); 
enable (adapter); 
// xuben: 调用 启动 搜索 方法 
adapter.startDiscovery(); 
// xuben: 如 果 此 时 状态 为 正在 搜索 ， 则 调用 取消 搜索 方法 ， 并 检验 返回 结果 是 否 正确 
if(adapter.isDiscovering() ){ 
assertTrue (adapter.cancelDiscovery()); 
} 
} 





LU 
XOK， 新 的 测试 集 建立 了 ， 测 试用 例 也 完成 了 ， 那 么 ， 如 何 才能 让 CTS 框 架 知道 有 这 个 用 例 集 并 运行 这 些 用例 呢 ? 


eo 我 们 需要 修改 该 包 的 Android.mk 文 件 。 








修改 该 包 的 Android.mk ( 即 “~\cts\tests\tests\bluetooth_More\Android.mk”) ， 将 其 修改 为 LOCAL PACKAGE_NAME:=CtsBluetoothTestCases_More， 如 图 17-7 所 示 。 


# See the License for the specific language governing permiss 
# limitations under the License. 


LOCAL PATH:- $(call my-dir) 


include $(CLEAR VARS) 


LOCAL PACKAGE NAME := CtsBluetoothTestCases More 


# Don't include this package in any target. 
LOCAL MODULE TÀGS := optional 


# When built, explicitly put it in the data partition. 
LOCAL MODULE PATH := $(TARGET OUT DATA APPS) 


# All tests should include android. test. runner. 
LOCAL JAVA_LIBRARIES := android. test. runner 


LOCAL SRC FILES := $(call all-java-files-under, src) 








图 17-7 Android.mk 
(o am 文件 名 、 包 名 和 类 名 都 需要 改 成 新 名 字 。 
人 搞定! 这 样 就 行 了 吗 ? 
eo. 不 行 ， 还 得 修改 CtsTestCaseList.mk 文 件 。 


接 下 来 ， 还 得 在 “~/cts” 目 录 下 的 CtsTestCaseList.mk 文 件 内 添加 “CtsBluetooth-TestCases_More\ 这 个 新 增 测试 用 例 集 ， 如 图 17-8 所 示 。 








# These test cases will be analyzed by the CTS API coverage tools. 
CTS COVERAGE TEST CASE LIST := 
CtsAccessibilityServiceTestCases V 
CtsÁccountManagerTestCases X 
CtsAppTestCases X 


CtsBluetoothTestCases More ^ 


CtsContentTestCases V 
CtsDatabaseTestCases V 
CtsDpiTestCases A 

CtsDpiTestCases2 \ 

CtsExampleTestCases X 
CtsGestureTestCases X 
CtsGraphicsTestCases \ 





图 17-8  CtsTestCaseList.mk 
$9,... 自 定义 CTS 用 例 集 就 算 完 成 了 ， 下 面 咱 们 运行 一 下 看 看 吧 ! 
1724 ”运行 自 定义 CTS 用 例 集 
F —Pp— 


$9. ， 只 需 重新 编译 CTS 这 部 分 就 好 了 1 








OK, 一 切 具备 ， 重 运行 .build/envsetup.sh 脚 本 ， 重 新 编译 CTS， 如 下 。 





$ chmod 777 build/envsetup.sh 
$ build/envsetup.sh 
$ make cts 





此 时 ， 再 输入 如 下 命令 。 





cts-tf > list packages 





就 可 以 看 到 新 添加 的 用 例 集 。 


通过 start--plan CTS-p< 新 用 例 集 名 > 即 可 运行 新 测试 用 例 集 ， 如 下 。 





cts-tf > start --plan CTS -p android.bluetooth.cts.BluetoothDeviceTest 





< 运行 完成 后 该 干什么 ? 


eo... 先 看 看 测试 报告 吧 ! 


运行 完成 后 ,在 “~/android-cts/repository/results” 目 录 下 找到 本 次 测试 的 测试 报告 : testResult.xml， 在 浏览 器 中 打开 该 报告 后 ， 将 发 现 CtsBluetoothTestCases_More 这 个 新 增 测试 集 已 经 赫然 
在 列 (这 里 巴 哥 奔 添加 了 14 个 新 测试 用 例 ) ， 如 图 17-9 所 示 。 








Test Summary by Package 





图 17-9  testResult.xml 


E s. 还 真 多 了 咱们 添加 的 测试 用 例 集 ! 


e aa. 点 击 用 例 集 看 看 ! 





点 击 即 可 看 到 这 14 个 用 例 均 测 试 通过 ， 包 括 搜索 (test_startDiscovery()) 与 取消 搜索 (test_isDiscoverfing_cancelDiscovery()) 两 个 示例 用 例 ， 如 图 17-10 所 示 。 


Compatibility Test Package: CtsBluetoothTestCases More 


-- test_isDiscovering cancelDiscovery | ^ pass | 








图 17-10 ”示例 用 例 对 应 报告 


Bur 以 后 可 以 随时 根据 项 目 需要 通过 CTS 框 架 进行 各 种 单元 测试 了 ! 


17.3 ”定制 单元 测试 脚本 总 结 


OS. xx, 算 你 将 功 补 过 了 1 

Raa, 虽然 CTS 自 定义 用 例 集 不 算是 新 工具 开发 ， 但 其 非常 有 效 地 利用 了 已 有 测试 框架 ， 这 种 事半功倍 的 事情 符合 我 的 性 格 。 
E... CTS 自 定义 用 例 集 有 风险 吗 ? 

, eee rey 的 补充 不 应 该 产生 太 多 的 后 遗 症 ,但 处 理 不 当 也 容易 产生 几 个 方面 的 困扰 。 

Eas 说 来 听 听 ! 

PO, uns 测试 员 都 习惯 直接 运行 所 有 用 例 ， 但 我 们 自己 添加 的 用 例 难免 会 考虑 得 不 全 ， 最 终 导 致 误 报 bug。 

Reoti py 

RO sanan 自 定义 的 用 例 集 时 ， 一 定 要 判断 fail 项 究竟 是 API 出 问题 还 是 我 们 用 例 本 身 的 问题 。 

E on, 还 有 什么 困扰 ? 


e 还 有 就 是 ， 很 多 同学 偷懒 将 用 例 集 直接 写 入 CTS 官 方 用 例 下 面 ， 这 将 导致 两 个 问题 。 


fe 
全 哎呀， 我 就 是 这 样 做 的 ， 会 有 哪些 问题 ? 


eo. ouis, 咱们 添加 的 用 例 集 就 会 被 替换 ; 

其 二 是 咱们 日 常 的 CTS 报 告 不 应 该 有 针对 项 目的 自 定义 测试 用 例 集 。 

fe 

SAB RIG EA DPE? 

全 en 自 定义 的 用 例 集 主要 用 于 项 目测 试 ， 最 好 与 CTS 官 方 用 例 完 全 分 开 ，CTS 官 方 用 例 用 于 日 常 CTS 测 试 ， 而 咱们 自己 的 用 例 集 则 需要 单独 维护 。 

E 

SFR, CARE LEE HY? 

| cores 就 是 咱们 需要 随时 关注 CTS 官 方 用 例 的 更 新 ， 如 果 官 方 提供 更 好 、 更 全 面 的 用 例 ， 或 者 某 些 API 已 经 被 官方 删除 ， 那 咱们 相应 的 用 例 也 需要 进行 一 些 调整 。 


E 
人 好 的 ， 看 来 自 定义 测试 用 例 集 还 真 需要 花 些 时 间 来 维护 ! 


第 18 章 Android 自动 化 实践 之 路 





听 听 真实 的 实践 之 路 ， 或 许 能 得 到 一 些 别 样 的 启发 。 


Se 


倒 奔 哥 ， 说 说 你 真实 的 自动 化 之 路 呐 ! 你 一 路 走 来 相信 不 是 按照 这 个 顺序 吧 ? 


go... 还 真 不 是 。Android 的 自动 化 之 路 有 很 多 入 口 ， 有 的 看 似 简单 实则 陷阱 无 数 ， 有 的 看 似 复杂 实则 清晰 易 行 。 
a 


Be 
全 % 那 你 说 说 你 真实 走 过 的 那 条 路 吧 ， 我 最 喜欢 听 故 事 了 1 


Se 我 最 初 接触 自动 化 是 通过 运行 monkey 命 令 相关 参数 进行 一 系列 稳定 性 测试 ， 当 时 并 没 觉察 出 monkey 与 Android 自 动 化 有 着 千 丝 万 缕 的 联系 ， 只 是 简单 将 monkey 作 为 黑金 测试 辅助 工具 中 的 一 种 
进行 使 用 。 


全 % 是 啊 ，monkey 可 以 说 是 黑 鲍 测试 人 员 用 得 最 为 频繁 的 一 个 小 工具 了 。 

ao, isis di 黑金 测试 团队 提出 需求 ， 说 总 是 传 参 错 误 ， 而 且 很 多 新 人 都 不 会 用 命令 提示 符 ， 于 是 我 就 给 大 家 开发 了 一 款 简易 的 带 界 面 的 传 参 小 工具 。 
s» 

SERIE AEH fik FAG ER iT At} monkey it4T T KR! 

G2 04, 过 了 一 段 时 间 ， 黑 使 测 试 团队 又 提出 需求 ， 说 需要 一 款 能 够 录制 /回放 的 小 工具 ， 以 便 新 人 能 快速 上 手 。 于 是 ， 我 开始 学 习 monkeyrunner 并 推荐 给 大 家 。 
-人 哈哈， 看 来 需求 是 最 大 的 动力 ， 促 使 我 们 不 断 学 习 1 


$6... 不 过 没 多 久 ， 大 家 就 开始 抱怨 monkeyrunner 的 录制 /回放 非常 难 用 ， 刚 好 我 正在 深入 研究 monkey 的 原理 ， 于 是 就 基于 monkey 开 发 了 那 款 录 制 /回放 小 工具 。 





Sa% 想 不 到 奔 哥 还 没 接触 Instrumentation， 就 先 开发 了 几 款 小 工具 。 


22 45, 其 实 开 发 小 工具 也 是 熟悉 原理 的 一 条 捷径 。 再 后 来 ， 由 于 项 目的 需要 ， 巴 哥 奔 开 始 接 触 CTS。 一 开始 也 只 是 用 Android 这 套 兼容 性 测试 框架 对 项 目 进 行 简单 的 兼容 性 测试 ， 并 定期 将 报告 发 
给 研发 人 员 定 位 问题 。 

E 
从 那 时 公司 还 没有 自动 化 团队 吧 ， 怎 么 什么 都 让 你 做 ? 
26... 当时 自动 化 团队 还 处 于 初 建 中 ， 而 且 我 刚 一 接触 CTS 就 深 深 地 爱 上 了 这 个 迷人 的 单元 测试 框架 ， 几 乎 每 天 都 要 加 班 研究 CTS 的 用 例 ， 乐 此 不 羧 ! 


E 
全 能 感觉 到 ， 当 奔 哥 带领 我 接触 CTS 用 例 后 ， 我 也 震惊 了 ， 简 直 就 是 一 个 单元 测试 用 例 的 宝藏 ! 


9o... 随 着 对 CTS 中 接口 测试 的 了 解 ， 以 及 研发 部 门 和 测试 新 人 对 测试 小 工具 需求 的 不 断 扩大 ， 我 开始 试 着 开发 其 他 黑 盒 测试 辅助 工具 : 诸如 WIf 开 关 、 蓝 牙 传 文件 、GPS 模 拟 、Sensor 数 据 检 


测 、 电 源 管理 和 短信 发 送 等 常用 小 工具 。 


和 此 时 ， 巴 哥 奔 仍旧 只 是 为 测试 需要 而 开发 ， 有 时 甚至 是 为 开发 而 开发 ， 并 没有 意识 到 这 些 工 具 之 间 的 联系 。 
= 
Sole, deb HF YG WPI A Rail do f] ECTS P 3f du JR PE? 


$69, .. 当 巴 哥 奔 越 来 越 被 CTS 的 简洁 和 实用 所 吸引 ， 开 始 深入 研究 CTS 并 试 着 为 CTS 添 加 更 多 的 测试 用 例 ， 通 过 对 CTS 测 试用 例 的 学 习 、 编 译 和 使 用 ， 尤 其 是 对 项 目测 试 重点 和 Bug 频 发 的 基本 接 
有 针对 性 地 添加 更 多 更 强大 的 用 例 到 CTS 框 架 中 运行 ， 使 得 巴 哥 奔 对 CTS 有 了 更 深 的 理解 。 


"m 
TUR RM AT ARAL MEAT PAH ER! 
= GP ， 不 过 这 些 毕竟 不 是 真正 的 自动 化 测试 ，monkey 父 子 的 脚本 完全 不 具备 稳定 性 和 可 移植 性 。 


QO atacs 了 解 的 深入 ， 巴 哥 奔 不 仅 重 温 了 JUnit 单 元 测试 框架 ， 更 进一步 领悟 到 Instrumentation 这 把 “ 属 龙 刀 ”的 威力 。 


正好 此 时 自动 化 团队 初 具 锥 形 ， 于 是 巴 哥 奔 和 大 家 一 起 闻 入 到 Instrumentation 的 世界 。 





So 
Xe EE, MAER! 


eo... 接触 Instrumentation 一 段 时 间 后 ， 大 家 就 开始 正式 针对 项 目 进行 大 规模 脚本 开发 了 ， 开 发 的 过 程 是 痛苦 的 ， 遇 到 了 一 系列 问题 ， 也 尝试 了 很 多 业界 封装 好 的 框架 ， 比 如 Robotium， 但 最 终 都 
因为 这 样 那样 的 问题 而 搁置 。 


EC] 
< 于 是 你 们 就 决定 对 Instrumentation 进 行 二 次 封装 ? 胆 提 肥 啊 ! 


POs, 可 以 说 ， 这 条 路 百 转 千 回 ， 大 家 在 措 着 石头 过 河 的 过 程 中 不 断 地 对 封装 进行 重 构 ， 而 重 构 拖 的 时 间 越 长 ， 团 队 整 体 产 出 就 越 低 ， 巴 哥 奔 与 小 伙伴 们 心急 如 焚 。 








"ME RUM 


eo... 幸而 同类 型 公司 许多 自动 化 团队 也 在 做 着 同样 艰难 的 挣扎 ， 这 给 了 大 家 坚持 下 去 的 勇气 和 一 定 要 做 得 更 漂亮 的 信心 。 


Se 
多 嗯 ， 这 次 封装 一 定 拿 了 个 大 奖 吧 ? 





eo... 正在 大 家 咬 紧 牙关 迎 着 暴雨 艰难 地 向 前 迈进 时 ，Android 官 方 推出 了 自动 化 终极 利器 UIAutomator， 这 个 消息 对 于 刚 入 门 做 自动 化 的 困 队 而 言 自然 是 如 春风 送 雨 。 


B®. ru. EXAJZ. H) *HnstrumentationiE 4T — Kk 33 #4 A Pm & 2p X e 3 — xe. 


不 过 ， 自 动 化 就 是 这 样 ， 必 须 立即 放弃 对 旧 有 奶酪 的 幻想 ， 全 身心 地 投入 到 新 奶酪 的 探寻 之 路 ， 才 能 不 被 时 代 所 抛弃 。 





令 % 自 动 化 之 路 的 确 充满 艰辛 和 不 确定 性 。 


$99, ,. 不 过 不 得 不 承认 UIAutomator 的 确 是 一 款 杀 手 级 的 自动 化 框架 ， 这 个 框架 让 巴 哥 奔 看 到 了 微软 当年 万 夫 英 敌 的 自动 化 抓 取 框架 Xacc 的 影子 ， 也 让 大 家 领略 到 成 熟 自动 化 框架 所 带 来 的 开发 的 
快感 。 


人 也 一 定 发 现 了 它们 之 间 的 互补 性 吧 ? 


eo. 


E 


通过 对 UIAutomator 的 实践 ， 巴 哥 奔 和 同事 们 将 Instrumentation 封 装 得 更 为 完美 ， 而 UIAutomator 所 不 能 触及 的 恰恰 又 可 通过 Instrumentation 完 成 。 
9o, 以 说 ， 任 何 努力 都 不 会 白费 ， 就 是 这 个 道理 。 
仿真 不 容易 ! 


959. eaae nr 到 目前 为 止 所 走 过 的 Android 实 践 之 路 ， 相 信 很 多 地 方 都 有 各 位 同仁 们 的 足迹 ， 只 不 过 ， 走 的 人 乱 了 ， 路 也 跟着 杂乱 无 章 起 来 ! 




















Android 自 动 化 工具 总 结 如 图 18-1 所 示 。 























monkeyNLR |o: 界面 运行 器 : 传 参 小 工具 
脚本 生成 器 : monkey 脚 本 录制 工具 
源码 问题 
控件 问题 
用 例 结构 问题 
一 ”Instrumentation 二 次 封装 O 运行 日 志 问 题 
| 
控件 ID 重复 或 缺失 问题 
出 错 截屏 问题 











”UIAutomator 插 件 i o PCR AS SEE 


。 CTS 自 定义 o 定制 化 单元 测试 脚本 开发 


图 18-1 Android 自 动 化 工具 总 结 


第 四 部 分 ”反思 篇 


Pe 关于 工具 的 反思 


: 第 20 章 ”关于 测试 的 反思 


“第 21 章 关于 人 的 反思 


第 19 章 ”关于 工具 的 反思 


19.1 关于 录制 /回放 工具 的 幻想 


L PEN 有 一 个 传说 ， 它 的 名 字 叫 录制 /回放 。 

se 

全 区 不 知道 什么 原因 ， 很 多 BOSS 都 会 对 录制 /回放 工具 抱 有 很 大 的 幻想 。 

? uas 最 为 普遍 的 解释 是 : 一 旦 有 了 强大 的 、 门 槛 极 低 甚 至 无 门槛 的 录制 /回放 工具 ， 黑 鳃 测试 人 员 就 全 部 解放 出 来 ,他们 只 需要 操作 一 遍 (录制 ) ， 剩 下 的 就 交 给 工具 去 完成 。 


$9... 想 早已 被 国外 自动 化 牛人 们 在 博客 和 技术 书籍 拿 出 来 批判 过 多 次 ， 但 似乎 国内 BOSS 是 不 看 牛人 博客 和 技术 书籍 的 。 


他 们 只 知道 不 断 给 自动 化 工程 师 施 压 ， 强 迫 大 家 做 出 傻瓜 的 、 更 傻瓜 的 、 更 更 傻瓜 的 录制 /回放 工具 。 


ie 
全 如 果 脚 本 稳定 性 不 好 ， 那 肯定 是 自动 化 工程 师 水 平 不 够 。 
如 果 脚 本 难以 维护 ， 那 一 定 是 自动 化 工程 师 经 验 不 足 。 


如 果 脚 本 移植 出 错 ， 那 必然 是 自动 化 工程 师 考 虑 不 周 。 


s» 
SRR GO, Sebb/ ALIA HP OKAY RAM AP BALA CASES 


Jo RAY FOB MAR AA SIICARMAR, PEKACETRLRET. 


如 果 维 护 和 移植 人 员 是 黑金 测试 员 ， 那 就 等 着 挨 批 吧 
Ls cun: 要 不 养 你 们 这 帮 人 干 嘛 使 的 ? 要 知道 你 们 可 是 整个 测试 团队 花 我 银子 最 多 的 一 帮 人 。 


Orar, 巴 哥 奔 想 提醒 各 位 
的 产品 ) 


意 屈 尊 看 本 书 的 大 小 BOSS 一 句 话 ， 自 动 化 实施 最 关键 的 不 是 脚本 数量 (当然 数量 上 不 去 肯定 不 行 ) ， 也 不 是 界面 足够 傻瓜 (毕竟 自动 化 工具 不 是 需要 照顾 广大 群体 





而 是 脚本 质量 (稳定 性 、 可 移植 性 和 可 维护 性 等 ) ， 而 脚本 质量 的 保障 是 建立 在 脚本 开发 团队 在 实践 中 不 断 提炼 和 打磨 脚本 ， 不 断 修炼 优化 脚本 的 能 力 来 达到 的 。 
65, cans, 自动 化 实施 不 就 是 自动 化 工具 发 布 和 黑 盒 测试 团队 运行 吗 ? 我 可 支付 不 起 更 多 的 闲人 。 


eo. 果 您 坚持 这 么 认为 ， 那 我 也 没 办 法 。 


在 我 看 来 ， 一 个 完备 的 自动 化 实施 = 工具 开发 与 维护 团队 + 脚本 编写 与 维护 团队 + 脚本 运行 团队 。 其 中 ， 工 具 开 发 和 维护 团队 的 人 数 不 必 多 ,但 必须 精 ， 脚 本 编写 与 维护 团队 人 数 略 多 且 脚 本 编写 经 验 
足 ， 这 两 部 分 是 自动 化 团队 的 重点 。 


脚本 运行 团队 可 由 黑 鳃 测试 团队 指派 几 名 对 自动 化 兴趣 浓厚 且 经 过 培训 的 测试 员 ， 随 时 反馈 异常 和 错误 情况 。 只 有 这 样 的 搭配 才能 指望 做 成 一 些 事情 。 


868, nx. 我 们 是 要 门槛 还 是 要 适 配 ? 


第 19 章 ”关于 工具 的 反思 


19.1 关于 录制 /回放 工具 的 幻想 





L_ Pees 有 一 个 传说 ， 它 的 名 字 叫 录制 /回放 。 

Se 

全 和 不 知道 什么 原因 ， 很 多 BOSS 都 会 对 录制 /回放 工具 抱 有 很 大 的 幻想 。 

BS ous, 最 为 普遍 的 解释 是 : 一 旦 有 了 强大 的 、 门 槛 极 低 甚 至 无 门槛 的 录制 /回放 工具 ， 黑 金 测 试 人 员 就 全 部 解放 出 来 ， 他 们 只 需要 操作 一 遍 (RA) ， 剩 下 的 就 交 给 工具 去 完成 。 


全 So 想 早已 被 国外 自动 化 牛人 们 在 博客 和 技术 书籍 拿 出 来 批判 过 多 次 ， 但 似乎 国内 BOSS 是 不 看 牛人 博客 和 技术 书籍 的 。 


他 们 只 知道 不 断 给 自动 化 工程 师 施 压 ， 强 近 大 家 做 出 傻瓜 的 、 更 傻瓜 的 、 更 更 傻瓜 的 录制 /回放 工具 。 


E 
全 % 如 果 脚 本 稳定 性 不 好 ， 那 肯定 是 自动 化 工程 师 水 平 不 够 。 


如 果 脚 本 难以 维护 ， 那 一 定 是 自动 化 工程 师 经 验 不 足 。 

如 果 脚 本 移植 出 错 ， 那 必然 是 自动 化 工程 师 考虑 不 周 。 

人 殊不知， 录制 /回放 工具 所 能 产 出 的 脚本 本 身 就 是 脚本 维护 和 移植 人 员 的 蛋 梦 。 

如 果 脚 本 维护 和 移植 人 员 是 自动 化 团队 人 员 ， 那 苦水 自己 吞 了 也 就 罢了 。 

如 果 维 护 和 移植 人 员 是 黑金 测试 员 ， 那 就 等 着 挨 批 吧 

OO po 要 不 养 你 们 这 帮 人 干 嘛 使 的 ? 要 知道 你 们 可 是 整个 测试 团队 花 我 银子 最 多 的 一 帮 人 。 


Be ay, 巴 哥 奔 想 提醒 各 位 愿意 屈 苯 看 本 书 的 大 小 BOSS 一 句 话 ， 自 动 化 实施 最 关键 的 不 是 脚本 数量 ( 当然 数量 上 不 去 肯定 不 行 ) ， 也 不 是 界面 足够 傻瓜 《毕竟 自动 化 工具 不 是 需要 照顾 广大 群体 
的 产品 ) 


而 是 脚本 质量 (稳定 性 、 可 移植 性 和 可 维护 性 等 ) ， 而 脚本 质量 的 保障 是 建立 在 脚本 开发 团队 在 实践 中 不 断 提炼 和 打磨 脚本 ， 不 断 修炼 优化 脚本 的 能 力 来 达到 的 。 
65, cans, 自动 化 实施 不 就 是 自动 化 工具 发 布 和 黑 盒 测试 团队 运行 吗 ? 我 可 支付 不 起 更 多 的 闲人 。 


eo, 果 您 坚持 这 么 认为 ， 那 我 也 没 办 法 。 


在 我 看 来 ， 一 个 完备 的 自动 化 实施 = 工具 开发 与 维护 团队 + 脚本 编写 与 维护 团队 + 脚本 运行 团队 。 其 中 ,工具 开发 和 维护 团队 的 人 数 不 必 多 ,但 必须 精 ， 脚 本 编写 与 维护 团队 人 数 略 多 且 脚 本 编写 经 验 
这 两 部 分 是 自动 化 团队 的 重点 。 


脚本 运行 团队 可 由 黑金 测试 团队 指派 几 名 对 自动 化 兴趣 浓厚 且 经 过 培训 的 测试 员 ， 随 时 反馈 异常 和 错误 情况 。 只 有 这 样 的 搭配 才能 指望 做 成 一 些 事情 。 


和 未 你 们 说 ， 我 们 是 要 门槛 还 是 要 适 配 ? 


19.2 ”要 门槛 还 是 要 适 配 





下 面 是 脑筋 急 转 弯 时 间 ， 请 听 题 : 高 门槛 低 适 配 和 高 适 配 低 门 槛 ， 你 选 哪 一 个 ? 


BO. usas, 这 个 话题 被 无 数 次 提 及 和 讨论 ， 在 这 里 ， 我 想 深入 挖 据 一 下 问题 的 根源 。 


众所周知 ， 工 具 使 用 门槛 越 低 ， 就 要 求 工 具 所 抓 取 到 的 控件 元 素 越 确定 〈 即 必 能 抓 到 ， 如 控件 坐标 或 索引 index) ， 而 越 确定 的 元 素 一 般 也 越 不 稳定 一 脚本 随时 会 由 于 平台 分 辨 率 不 同 或 控件 位 置 移 动 
而 挂 掉 ; 


而 脚本 适 配 能 力 越 强 ， 就 要 求 工具 所 抓 取 的 控件 的 元 素 够 丰富 (如 控件 ID、 文 本 、 描 述 、 索 引 和 坐标 等 ) 以 便 搭配 使 用 ， 且 越 稳定 的 控件 元 素 (如 控件 描述 或 文本 ) 抓 取 优先 级 应 该 越 高 。 
ee... 自 相 了 矛盾 吗 ? 你 们 就 不 能 想 办 法 抓 取 那 种 既 确 定 又 稳定 的 元 素 吗 ? 不 要 总 摆 出 一 副 无 能 为 力 的 样子 ! 
ee 
泛泛 地 讨论 没有 任何 意义 ， 以 控件 文本 为 例 说 明 一 下 。 
写 过 自动 化 脚本 的 人 都 知道 ， 很 多 控件 是 没有 文本 的 《如 layout 或 通过 OpenGL 控 件 等 ) ， 这 意味 着 如 果 以 文本 为 主 很 多 测试 步骤 将 走 不 通 。 
再 以 控件 ID 为 例 ， 通 过 Hierarchyviewetr 可 以 清楚 看 到 很 多 控件 没有 ID 或 ID 同名 的 情况 ， 这 也 会 让 脚本 回放 出 现 问 题 。 
Be 
< 作怪 不 得 业界 没有 基于 Instrumentation 的 录制 /回放 工具 。 
这 也 是 你 当初 会 这 么 强烈 反对 开发 基于 UIAutomator 的 录制 工具 的 原因 吧 ? 
eo. ,. 这 样 的 工具 不 是 因为 技术 原因 难以 开发 ， 而 是 开发 出 来 根本 就 不 适用 、 不 好 用 ， 其 至 极 大 地 降低 效率 ， 最 终 将 事倍功半 。 
OO, 每 次 都 要 我 来 指导 你 们 : 这 些 问题 通过 各 元 素 搭配 使 用 ， 并 将 稳定 元 素 (如 控件 描述 或 文本 ) 优先 级 设置 得 更 高 不 就 可 以 解决 了 吗 ? 


E 
有 这 样 一 来 ， 就 需要 测试 人 员 不 仅 要 会 录制 脚本 ， 还 需要 学 会 如 何 修 正 脚 本 〈 用 更 稳定 的 元 素 替 代 其 他 元 素 ) ， 工 具 使 用 门槛 又 高 了 。 





Bey raras, 以 PC 上 最 广泛 被 使 用 的 QTP 为 例 。 
如 果 仅 使 用 QTP 的 录制 ， 那 你 只 能 完成 最 最 简单 的 脚本 ， 而 一 旦 任务 复杂 度 上 去 ， 就 必须 精通 参数 化 、 数 据 驱 动 、 描 述 性 编程 等 。 


仅 就 控件 抓 取 而 言 ， 很 多 控件 也 必须 使 用 QTP 控 件 抓 取 的 功能 抓 取 后 编程 ， 而 不 是 简单 地 录制 〈 漏 录 情 况 非常 普遍 ) 。 


Ossana, 测试 员 必 须 清 楚 如 何 设置 好 验证 点 和 意外 处 理 ， 否 则 漏 掉 bug 或 经 常 crash 都 将 让 人 难以 接受 。 


99, ou 不计 为 漏 录 导致 无 法 回放 的 情况 ， 单 就 界面 变化 (控件 位 置 移动 ) 和 分 辨 率 变化 所 导致 的 脚本 稳定 性 降低 所 造成 的 工作 量 就 够 受 的 了 ， 更 何况 脚本 移植 需要 的 门槛 会 更 高 。 
< 人 % 有 位 作家 曾 说 过 ， 有 的 文章 刚 出 版 就 已 经 死 了 。 门 槛 极 低 的 录制 工具 所 录制 出 来 脚本 也 是 一 样 ， 刚 录 出 来 就 已 经 没有 生命 力 了 ， 它 们 的 生命 周期 极其 短暂 ， 而 且 完全 得 看 界面 的 脸色 行事 。 
BO 

类 似 的 话说 再 多 也 无 济 于 事 。 
巴 哥 奔 只 想 提醒 各 位 BOSS: 微软 在 拥有 源码 的 情况 下 也 没有 正式 推出 过 任何 基于 Windows 的 录制 /回放 工具 ， 微 软 的 自动 化 脚本 开发 是 基于 一 个 个 强大 的 控件 抓 取 工具 ， 而 非 录 制 /回放 工具 。 


用 BOSS 们 的 推论 : 微软 自动 化 工具 使 用 门槛 这 么 高 ， 看 来 微软 自动 化 团队 成 员 的 水 平 的 确 不 咋 地 ! 


人 en 究竟 什么 样 的 自动 化 框架 才 是 强大 的 框架 ? 


19.3 ”什么 样 的 自动 化 框架 才 是 强大 的 框架 





强大 这 个 词 ， 简 直 强 大 到 不 敢 随 便 用 ! 


人 ya 自动 化 测试 工作 的 工程 师 都 会 有 这 样 的 感触 。 
无 论 是 PC 上 无 比 强 大 的 QTP， 还 是 现在 Android 上 被 命名 为 XXXRobot 或 XXXRunner 或 SmartXXX 或 AutoXXX 的 各 类 自动 化 框架 ; 


无 论 生成 的 脚本 是 JavaScript/VBScript/Java/C# 还 是 各 种 伪 代 码 ， 也 无 论 界面 是 如 何 丰 富 或 简洁 ， 其 原理 大 同 小 异 。 





全 但 无 形 中 总 有 一 种 趋势 在 左右 着 我 们 ， 似 乎 最 基本 的 捕获 、 转 换 太 简单 ， 录 制 /回放 也 不 够 用 ， 而 必须 发 展 为 某 种 复杂 的 、 高 度 集成 的 测试 套件 才 算 牛 ! 


eo, 巴 哥 奔 经 历 的 一 些 项 目 为 例 。 
当 大 家 通宵 达旦 开发 出 一 款 简 约 而 又 简单 的 强 适 配 〈 脚 本 通用 性 、 移 植 性 俱 佳 ) 的 自动 化 框架 时 ， 周 围 马上 会 响起 一 种 声音 。 


这 声音 不 是 让 我 们 把 框架 的 适 配 性 做 得 更 强 ， 也 不 是 希望 我 们 添加 诸如 脚本 管理 、 函 数 级 关联 用 例 、 数 据 驱 动 等 基本 功能 。 


| CT: ARAB 0 ARKAE HA Demo, AHER “-KAKMMANHP 3 65 3e $ EUER A RRS HU” s RA, TERRIER MIAGE T -RIL 


不 断 地 更 新 ， 不 断 地 展示 ， 不 断 地 拉 大 旗 作 虎 皮 ， 一 款 原本 非常 实用 的 框架 就 这 样 被 拖 入 了 无 尽 的 沼泽 ， 直 到 被 新 的 框架 所 替代 。 


Ge 你 是 真 不 想 干 了 还 是 咋 的 ? 


eo, ,. 巴 哥 奔 呐 喊 : 一 款 真正 强大 的 工具 不 是 做 出 了 多 少 非常 炫 的 外 观 和 特效 ， 不 是 集成 了 多 少 业 界 推 党 的 测试 理论 和 管理 功能 ， 而 是 足够 实用 ! 
巴 哥 奔 始 终 认为 ， 简 单 、 实 用 是 判断 一 款 自动 化 工具 好 坏 的 第 一 标准 ， 一 款 不 断 被 使 用 、 被 批评 、 被 打磨 的 工具 才 是 好 工具 。 


工具 做 得 再 炫 却 无 人 使 用 ， 功 能 集成 得 再 多 却 连 最 基本 的 控件 抓 取 痢 错漏 百 出 ， 巴 哥 奔 实在 不 知道 这 款 工具 做 出 来 给 谁 用 ? 


E 
全 在 简单 、 实 用 的 基础 上 ， 我 们 需要 考虑 的 是 业务 上 实 实在 在 的 需求 ， 而 不 是 BOSS 们 想 看 到 什么 ! 


只 有 针对 需求 做 出 来 的 一 个 个 功能 点 才 会 让 工具 在 不 断 更 新 的 过 程 中 保持 生命 之 树 常 青 ， 而 一 款 绚丽 的 Demo 永 远 只 是 流星 ， 当 流星 划 过 的 时 候 ， 做 出 这 款 自动 化 框架 的 工程 师 也 该 打 背 包 准 备 走 人 了 1! 
-Le 


eo, 咱们 聊 聊 第 七 个 馒头 吧 ! 


194 将 第 七 个 馒头 扔 出 窗外 





eo. BT EL SICH] EAE T SC ASI EUR IR, RAE AS TOME IRE: 究竟 是 自 研 工具 还 是 买 第 三 方 现成 的 工具 ? 
$» 


sx 如 果 不 买 ， 那 自动 化 团队 就 得 自己 开发 出 一 款 来 ， 如 果 开 发 进度 较 慢 或 者 开发 出 来 的 东西 与 第 三 方 相 比 有 任何 不 足 ， 那 自动 化 团队 就 必须 承担 延误 测试 的 责任 。 说 白 了 ， 就 是 不 买 的 黑 锅 你 来 背 1 


E! 


Bax, 那 自 动 化 团队 必须 保证 钱 没 白花 ， 未 来 工具 不 好 用 ， 自 动 化 团队 必须 承担 采购 责任 。 说 白 了 ， 就 是 买 的 黑 锅 你 也 背 ! 

ae。 招 你 们 来 就 是 替 我 背 黑 锅 的 ! 

QO, iin, 问题 是 ， 这 款 工 具 是 测试 真正 需要 的 工具 吗 ? 如 果 不 是 ， 那 干 嘛 非 要 自动 化 团队 浪费 时 间 去 评估 ? 
Q9. 我 们 自动 化 工具 的 目标 不 是 要 模仿 业界 现 有 的 工具 和 技术 ， 而 是 要 站 在 巨人 的 户 上 ， 在 下 一 个 路 口 超 越 他 们 ! ! ! BOXE! 


$9... ua 站 在 巨人 肩 上 ， 不 要 重复 造 轮子 ， 从 已 产品 化 的 工具 中 学 习 ， 还 可 避免 自身 工具 前 期 稳定 性 差 、 界 面 不 够 友好 等 问题 。 


但 BOSS 们 没 考虑 到 的 是 : 第 三 方 工具 是 否 真 的 如 宣传 般 一 劳 永 选 ? 如 此 打压 自身 的 开发 会 不 会 造成 自动 化 牛人 的 严重 流失 ? 自动 化 执行 人 员 会 不 会 对 第 三 方 工具 产生 严重 依赖 ? 


pe 


于 第 三 方 工具 开发 的 脚本 未 来 不 续费 会 不 会 没 法 运行 ? 甚至， 自动 化 团队 会 不 会 最 终 沦落 为 第 三 方 工具 推广 团队 ? 


go 


《这 让 我 想起 一 个 老 笑 话 : AIR, d tah TAMER FRET Be, LABRET IT I! 


i 


这 时 他 说 了 一 句 话 : “ 早 知道 吃 这 个 就 饮 了 就 直接 吃 这 个 了 。” 言 外 之 意 前 面 六 个 都 是 白 吃 的 ， 白 白浪 费 了 时 间 和 人 金钱 。 


B® son, PK KRG THAME HT, (AUT KB BOSSA, I BLA RI ay EMEA KB 
巴 哥 奔 同 意 一 味 地 模仿 将 难以 做 到 超越 ， 但 巴 哥 奔 更 清楚 ， 只 有 持续 进行 技术 积累 和 人 才 储备 的 公司 才 有 资格 说 超越 ! 


面 对 那 些 不 愿意 立足 于 自动 化 团队 实际 能 力 ， 不 愿意 面 对 自 动 化 团队 真正 实力 ， 不 愿意 跟 进 现 有 技术 ,而 成 天 幻想 着 去 哪 能 吃 到 第 七 个 馒头 一 下 子 就 饱 了 的 BOSS 们 ， 你 要 做 的 ， 只 有 坚定 不 移 地 将 第 七 
个 馒头 扔 出 窗外 。 





feo (c 
s a PARR, 没有 捷径 可 言 ， 想 要 直接 抄 近 道 的 投机 手段 是 不 可 能 做 出 任何 业界 领先 的 工具 的 。 
就 像 让 黑金 测 试 人 员 不 要 用 自动 化 现 有 工具 而 想 办 法 找到 一 种 让 黑金 测试 用 例 自动 运行 起 来 的 东西 一 样 。 


或 许 葵花 宝典 能 帮助 您 实现 这 个 梦想 ， 您 可 以 先 亲身 试用 看 看 ! 
Oe, 既然 自动 化 也 要 投资 ， 那 就 一 定 要 回报 。 


eo,,. 那 咱 们 分 析 一 下 ， 自 动 化 是 一 种 短线 投资 吗 ? 


第 20 章 ”关于 测试 的 反思 


20.1 自动 化 是 一 种 短线 投资 吗 





1 巴菲特 告 诚 我 们 : 要 长 线 不 要 短线 ! 
$e 
-全 必 自 动 化 业界 一 直流 传 着 牛人 Hancock 的 一 句 经 典 名 言 : 测试 自动 化 是 一 项 投资 ， 最 初 的 投资 可 能 很 多 ， 但 投资 的 回报 也 很 丰厚 ， 自 动 化 测试 运行 超过 15 次 以 后 ， 测 试 就 是 免费 的 了 。 


QO capa m amma cios T A RAR EY BB AOR, Ma AZ IRL IE REAL AE D AERE ER, TR AONE RAR GERM? 


当 一 款 产 品 的 某 项 功能 从 头 到 尾 其 至 测试 不 到 15 次 就 要 上 市 ， 那 还 需要 自动 化 吗 ? 当 针对 产品 某 一 特色 定制 产 出 自动 化 脚本 时 ， 黑 金 测试 已 经 完成 15 次 测试 中 的 8 次 ， 那 这 些 自动 化 脚本 还 有 运行 的 必要 
吗 ? 


当 为 某 一 版 本 开发 自动 化 脚本 时 听 到 传言 说 下 一 版 本 界面 将 有 大 幅 变更 ， 那 还 值得 为 该 版 本 开发 自动 化 脚本 吗 ? 
Se 
人性 这 些 问题 仁者 见 仁 ， 和 希望 朋友 们 不 要 人 云 亦 云 ， 应 独立 去 思考 。 


QO. ,reaexaxixkki BBC E P AERE BAA, duni HEI Re PPT "Ep CRAM” AAT OR TE 09 SEAT 


但 当 自动 化 只 能 通过 计算 当前 的 投资 回报 来 衡量 ， 只 把 自动 化 当做 一 种 短线 投资 ， 那 这 样 的 自动 化 是 不 是 也 做 得 太 功利 和 短视 了 一 点 ? 


Qo, sx. 自动 化 的 投资 回报 数据 不 能 让 BOSS 们 满意 ， 是 不 是 就 意味 着 自动 化 团队 应 该 在 测试 团队 的 组 织 架构 中 彻底 消失 ? 


又 或 裂变 为 数 个 各 自 为 政 的 工具 开发 团队 ? 也 许 不 是 没有 可 能 ， 也 许 这 已 经 在 很 多 中 小 企业 中 发 生 了 。 


fe 
CUORE, B SOLA TRE SUR X E? 
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20.1 自动 化 是 一 种 短线 投资 吗 





巴菲特 告诫 我 们 : 要 长 线 不 要 短线 ! 
全 区 自动 化 业界 一 直流 传 着 牛人 Hancock 的 一 句 经 典 名 言 : 测试 自动 化 是 一 项 投资 ， 最 初 的 投资 可 能 很 多 ， 但 投资 的 回报 也 很 丰厚 ， 自 动 化 测试 运行 超过 15 次 以 后 ， 测 试 就 是 免费 的 了 。 


GO. saco cios 随 着 版 本 选 代 频率 的 不 断 加 快 ， 随 着 版 本 之 间 随 时 发 生 着 的 颠覆 性 变革 ， 这 条 自动 化 的 摩尔 定律 是 否 还 奏效 ? 


当 一 款 产 品 的 某 项 功能 从 头 到 尾 甚至 测试 不 到 15 次 就 要 上 市 ， 那 还 需要 自动 化 吗 ? 当 针 对 产品 某 一 特色 定制 产 出 自动 化 脚本 时 ， 黑 金 测试 已 经 完成 15 次 测试 中 的 8 次 ， 那 这 些 自动 化 脚本 还 有 运行 的 必要 


当 为 某 一 版 本 开发 自动 化 脚本 时 听 到 传言 说 下 一 版 本 界面 将 有 大 幅 变 更 ， 那 还 值得 为 该 版 本 开发 自动 化 脚本 吗 ? 
人 性 这 些 问题 仁者 见 仁 ， 和 希望 朋友 们 不 要 人 云 亦 云 ， 应 独立 去 思考 。 


eo... 奔 很 清楚 完全 不 计 成 本 去 做 自动 化 是 件 非常 思春 的 举动 ， 也 知道 按照 某 些 所 谓 “ 自 动 化 实践 准则 ”应 该 如 何 做 倾向 性 的 选择 。 


但 当 自动 化 只 能 通过 计算 当前 的 投资 回报 来 衡量 ， 只 把 自动 化 当做 一 种 短线 投资 ， 那 这 样 的 自动 化 是 不 是 也 做 得 太 功 利和 短视 了 一 点 ? 


eo, ss. 自动 化 的 投资 回报 数据 不 能 让 BOSS 们 满意 ， 是 不 是 就 意味 着 自动 化 团队 应 该 在 测试 团队 的 组 织 架构 中 彻底 消失 ? 


又 或 裂变 为 数 个 各 自 为 政 的 工具 开发 团队 ? 也 许 不 是 没有 可 能 ， 也 许 这 已 经 在 很 多 中 小 企业 中 发 生 了 。 


-全 性 难 道 ， 自 动 化 就 是 为 了 替代 黑金 测试 而 生 ? 


20.2 ”难道 自动 化 是 为 了 替代 黑 盒 测试 





嫩 各 赤 代 轩 人 金 测试 不 是 技术 问题 ， 不 是 可 行 性 问题 ， 而 是 人 的 问题。 


fe 
人 不 仅 BOSS， 业 界 很 多 人 也 常常 在 自动 化 的 优势 里 面 列 上 一 条 : 替代 黑金 /功能 测试 。 


99... unn 自动 化 最 大 的 用 处 是 协助 黑金 测试 人 员 ， 而 不 是 替代 ! 

s» 

KAMARA? 难道 自动 化 没 办 法 验证 产品 功能 点 ? 难道 自动 化 覆盖 不 了 黑金 用 例 的 验证 点 ? 
B® ira, 不 过 更 实际 的 安排 是 : 自动 化 完成 它 所 擅长 的 工作 ， 配 合 黑金 测试 协同 进行 。 
s» 

那么， 我 们 就 需要 清楚 自动 化 擅长 什么 ， 不 擅长 什么 。 


eo 自动 化 擅长 对 现 有 黑 盒 用 例 做 回归 测试 ， 不 擅长 做 随机 测试 ; 








自动 化 擅长 对 数据 进行 验证 ， 不 擅长 对 图 片 进行 精细 比 对 《虽然 现在 已 经 有 很 多 工具 号 称 可 以 做 到 ， 但 就 灵活 性 和 效果 而 言 ， 与 测试 工程 师 是 无 法 相提并论 的 ) ; 








go 自动 化 擅长 高 效 运行 国定 操作 并 提供 规范 的 测试 报告 ， 不 擅 完 成 发 散 性 强 、 即 时 性 强 的 测试 任务 ; 


自动 化 擅长 协助 测试 人 员 进 行 double-check， 不 擅长 从 头 到 尾 独立 完成 测试 项 。 


fer 
Sho RY GH RAL RAN REA MIR, RARITA RENA RR AAR, BAY HAH T —Aimpossible mission. 


9o, .. KI LAF HH, AGE SEXUAL CAE UA AG E] SCIL FL SUA Ze Zr E PEARAN. de s] AHAL, REMRLALFREAMADAPR "eT HLM, Pet RMALEP 
最 “基本 ”也 最 “无 可 替代 ”的 角色 。 


o G 这 么 多 ， 衡 量 自动 化 效果 的 标准 不 就 是 bug 数 吗 ? 你 们 通过 自动 化 报 的 有 效 bug 越 多 ， 我 越 高 兴 ， 其 他 都 是 瞎 扯 。 





好 ， 那 咱们 就 来 看 看 这 个 问题 ! 


203 ”衡量 自动 化 效果 的 标准 是 Bug 数 吗 





当 某 件 事物 成 为 唯一 标准 后 ， 世 界 将 变 得 无 比 枣 怖 ! 

Se 

全 现在 一 切 似乎 都 要 量化 ， 要 KPI 化 ， 所 以 很 多 BOSS 能 想到 的 衡量 自动 化 的 标准 居然 是 : bug 数 ! BORSE 09 MIL A MIM IRAR RRA Zo 

e 9 自动 化 有 自动 化 的 评价 标准 和 效果 检验 方式 ， 比 如 灵活 性 、 稳 定性 、 履 盖 率 、 抽 和 象 程度 、 可 移植 性 、 易 用 性 和 维护 性 等 ， 但 其 中 大 部 分 指标 很 难 量 化 ， 或 者 说 ， 量 化 本 身 并 不 能 体现 其 价值 。 
到 而 且 一 旦 说 不 清楚 ， 就 很 容易 被 BOSS 抓 到 把 柄 ， 进 而 转 回 到 通过 bug 数 (或 有 效 bug 数 ) 进行 量化 ， 这 简直 就 是 一 场 避 梦 ! 

OO 白 了 ， 你 们 的 意思 是 自动 化 不 需要 发 现 bug 鹃 ， 如 果 连 bug 都 发 现 不 了 ， 那 我 养 你 们 干 嘛 ? 

全 《这 并 不 是 说 自动 化 不 需要 发 现 bug， 不 过 自动 化 的 bug 常 常 是 在 开发 自动 化 脚本 的 过 程 中 就 被 发 现 了 。 

eo, 自动 化 脚本 完成 后 ， 它 们 更 重要 的 职责 是 : 确保 被 覆盖 的 用 例 所 能 发 现 的 bug 不 被 漏 掉 ， 而 不 是 进行 创造 性 地 发 现 一 些 新 bug。 

SARIA HUGE: 自动 化 要 的 是 稳定 、 准 确 ， 而 不 是 标新立异 ! 


eo. 这 又 引发 了 下 一 个 问题 : 脚本 编写 者 的 态度 问题 。 


第 21 章 ”关于 人 的 反思 


21.1 ”测试 脚 本 编写 者 态度 问题 





态度 ， 是 一 切 事情 的 根本 ， 态 度 不 端 者 ， 必 将 一 无 所 成 ! 

$6,,... 您 觉得 自动 化 工程 师 算 是 开发 还 是 测试 呢 ? 

QO possar K, 但 整 天 在 那 写 代码 ， 而 且 招 你 们 的 目的 就 是 要 将 黑金 用 例 转 换 成 脚本 ， 那 你 们 不 是 开发 是 什么 ? 
3 


$e 
全 在 BOSS 看 来 ， 似 乎 脚本 编写 人 员 只 需要 简单 将 黑金 用 例 转 换 成 一 个 个 的 脚本 即 可 。 


9o,.. 自动 化 测试 脚本 完全 基于 黑金 设计 人 员 的 用 例 来 设计 有 多 么 不 靠 谱 ， 就 算 设 计 黑 金 用例 的 测试 员 在 整个 测试 困 队 测试 技术 方面 有 不 可 动摇 的 权威 ， 那 黑 盒 用 例 是 否 就 真 的 可 以 完全 转换 为 
自动 化 用 例 而 无 需 设计 呢 ? 


99... 自动 化 用 例 是 让 机 器 自动 运行 ， 而 黑金 用 例 则 是 让 测试 执行 者 去 执行 。 

Ls in 

Se 

全 嘿嘿， 我 第 一 次 听 时 也 觉得 是 废话 呢 ! 不 过 现在 越 想 越 觉 得 有 道理 ! 

09, ai cana 

| ————— 

QO kpa- narar, 你 需要 告诉 他 前 因 ( 预 置 条 件 ) GR (检查 点 ) ， 每 一 步 准确 地 需要 做 什么 〈 测 试 步骤 ) ， 以 及 需要 用 到 的 各 项 数据 (测试 数据 ) © 
当 你 让 机 器 去 执行 时 ， 也 需要 设置 预 置 条 件 、 检 查 点 、 测 试 步骤 和 测试 数据 。 

06... 所 以 我 才 说 这 两 者 没 区 别 啊 ! AR ARIE A? 


GO, cos asian AR. 你 需要 在 每 一 个 用 例 里 面 一 遍 遍 地 重复 写 上 预 置 条 件 、 检 查 点 、 测 试 步骤 和 测试 数据 ; 


而 当 你 为 机 器 编写 一 个 个 自动 化 测试 用 例 时 ， 很 多 公共 的 预 置 条 件 、 检 查 点 和 测试 步骤 都 可 以 提取 出 来 ， 作 为 公共 方法 ， 而 测试 数据 也 可 以 集中 放 在 一 个 地 方 ， 作 为 公共 数据 。 


fe 
a 


全 区 是 的 ， 如 果 这 些 公共 方法 的 提取 以 及 测试 数据 的 归 类 整合 不 经 过 一 系列 的 设计 ， 将 会 大 大 影响 测试 效率 ， 当 你 希望 做 数据 驱动 时 ， 这 点 尤为 重要 。 


| CFT AGER JG RR! 


eo, 问题 ， 说 到 底 还 是 人 的 问题 ! 


E 
SAB CET. AZ ARE eK E BACH RIE? 


第 21 章 ”关于 人 的 反思 


21.1 测试 脚本 编写 者 态度 问题 





是 态度， 是 一 切 事 情 的 根本 ， 态 度 不 端 者 ， 必 将 一 无 所 成 | 

Oros, 您 觉得 自动 化 工程 师 算是 开发 还 是 测试 呢 ? 

> 队 ， 但 整 天 在 那 写 代码 ， 而 且 招 你 们 的 目的 就 是 要 将 黑金 用 例 转换 成 脚本 ， 那 你 们 不 是 开发 是 什么 ? 
i» 

人 在 BOSS 看 来 ， 似 乎 脚本 编写 人 员 只 需要 简单 将 黑金 用 例 转换 成 一 个 个 的 脚本 即 可 。 


9o, .. 自动 化 测试 脚本 完全 基于 黑金 设计 人 员 的 用 例 来 设计 有 多 么 不 靠 谱 ， 就 算 设 计 黑 使用 例 的 测试 员 在 整个 测试 困 队 测试 技术 方面 有 不 可 动摇 的 权威 ， 那 黑 盒 用 例 是 否 就 真 的 可 以 完全 转换 为 
自动 化 用 例 而 无 需 设计 呢 ? 


eo, 巴 哥 奔 看 来 ， 自 动 化 用 例 是 让 机 器 自动 运行 ， 而 黑 使 用 例 则 是 让 测试 执行 者 去 执行 。 
05... 

Se 

嘿嘿， 我 第 一 次 听 时 也 觉得 是 废话 呢 ! 不 过 现在 越 想 越 觉得 有 道理 ! 

9 prate RARA 

Meneame 自动 运行 和 人 手工 执行 差别 真 的 只 在 效率 高 低 吗 ? 


QUO, eaa A knit, 你 需要 告诉 他 前 因 (MERE ER (检查 点 ) ， 每 一 步 准 确 地 需要 做 什么 〈 测 试 步骤 ) ， 以 及 需要 用 到 的 各 项 数据 (测试 数据 ) © 


当 你 让 机 器 去 执行 时 ， 也 需要 设置 预 置 条 件 、 检 查 点 、 测 试 步骤 和 测试 数据 。 
对 呀 ， 所 以 我 才 说 这 两 者 没 区 别 啊 ! 你 还 狂 辩 什么 ? 


QO, ces aH R AKANE, 你 需要 在 每 一 个 用 例 里 面 一 遍 遍 地 重复 写 上 预 置 条 件 、 检 查 点 、 测 试 步骤 和 测试 数据 ; 


而 当 你 为 机 器 编写 一 个 个 自动 化 测试 用 例 时 ， 很 多 公共 的 预 置 条 件 、 检 查 点 和 测试 步骤 都 可 以 提取 出 来 ， 作 为 公共 方法 ， 而 测试 数据 也 可 以 集中 放 在 一 个 地 方 ， 作 为 公共 数据 。 
s» 

全 是 的 ， 如 果 这 些 公共 方法 的 提取 以 及 测试 数据 的 归 类 整合 不 经 过 一 系列 的 设计 ， 将 会 大 大 影响 测试 效率 ， 当 你 希望 做 数据 驱动 时 ， 这 点 尤为 重要 。 

09. sit, AGE BG RR! 

9o ,... 说 到 底 还 是 人 的 问题 ! 


s» 
VG REA A AGE SB a UR AE? 


2 


Er. 


2 ”什么 人 适合 做 自动 化 





让 感 兴趣 的 人 做 感 兴趣 的 事 ， 赶 网 子 上 架 只 会 让 大 家 都 痛苦 ! 


$e 
全 《BOSS， 咱 们 公司 的 自动 化 人 员 你 打算 如 何 安排 ? 


io acm x 几 个 人 ， 还 能 怎么 安排 ? 自动 化 团队 负责 测试 框架 或 工具 开发 ， 其 他 测试 团队 负责 脚本 编写 和 维护 。 


eo... 这 样 一 来 ， 当 其 他 测试 团队 那些 对 自动 化 完全 不 了 解 的 leader 们 指定 人 员 来 做 自动 化 时 ， 戏 剧 性 的 画面 出 现 了 。 
如 果 此 时 自动 化 在 公司 较 受 重视 ， 则 他 们 将 指定 心腹 来 参加 ， 如 果 此 时 自动 化 在 公司 不 受 待 见 ， 则 他 们 将 指定 不 受 待 见 的 人 来 参加 。 


fe 
从 无 论 如 何 ， 最 终 参 与 进来 的 人 与 是 不 是 对 自动 化 感 兴趣 无 关 ， 与 有 没有 能 力 编写 和 维护 脚本 也 无 关 。 


| CPI 最 终 每 个 团队 挑选 出 来 的 人 ， 不 是 协助 推进 自动 化 的 ， 而 是 拖 自 动 化 后 腿 的 ? 


99, rakasnsa 队 去 宣 贯 、 培 训 和 深入 交流 ， 我 们 要 让 对 自动 化 感 兴趣 、 有 激情 的 人 主动 加 入 。 


我 们 要 给 他 们 创造 最 宽松 的 学 习 环 境 和 最 有 效 的 进 阶 路 线 ， 帮 助 这 些 真正 热爱 自动 化 的 人 一 起 成 长 ， 最 终 ， 他 们 将 是 推进 自动 化 最 强 有 力 的 骨干 力量 ! 


fe 
从 不 过 ， 就 像 之 前 说 的 ， 挑 选 只 是 第 一 步 ， 测 试 脚 本 编写 者 的 态度 转变 才 是 重点 。 


本 全 一 千 个 脚本 编写 者 也 会 写 出 一 千 个 风格 的 测试 脚本 〈 即 使 在 最 开始 就 提供 脚本 模板 并 规定 一 系列 要 求 的 情况 下 也 是 如 此 ) 。 
eo, ,. 如 果 不 能 保证 定期 (如 每 周 ) 做 codereview， 并 在 总 结 错误 基础 上 不 断 融入 新 的 脚本 编写 规则 ， 那 还 是 不 要 轻易 开始 大 批量 地 产 出 脚本 ， 否 则 未 来 的 脚本 维护 工作 会 让 你 吐血 。 
人 一般 而 言 ， 写 测试 框架 的 工程 师 不 愿意 “浪费 时 间 ” 去 写 测试 脚本 ， 而 写 测试 脚本 的 工程 师 又 不 具备 写 测试 框架 的 技术 和 经 验 。 


Q9, os rx, 两 者 应 该 严格 分 工 。 然 而 ， 实 践 证 明 ， 如 果 不 为 自己 框架 写 足够 多 的 脚本 ， 是 难以 意识 到 框架 局 限 性 为 脚本 创造 带 来 的 滴 苦 的 ， 而 一 味 写 脚本 也 难以 发 现 只 需 框架 稍 作 改 进 就 可 以 
大 幅 提 升 脚本 产 出 的 标准 化 和 效率 。 


895, rax 了 ， 你 们 的 建议 是 什么 ? 


COE BUS Ades A: 大 家 不 是 工作 上 的 合作 伙伴 ， 而 是 亲密 无 间 的 战友 ， 互 帮 互 助 ， 互 相 学 习 和 推进 ， 无 论 水 平 高 低 ， 无 论 经 验 多 少 ， 携 手 并 进 。 当 大 家 像 一 家 人 一 样 往 前 走时 ， 框 架 与 脚本 的 质 
量 才 能 得 以 完成 真正 的 变革 ! 


$9, ... 对 于 编程 水 平和 经 验 较为 薄弱 的 脚本 编写 者 而 言 ， 可 以 从 脚本 的 逻辑 入 手 ， 不 断 改 善 脚 本 的 清晰 度 ， 不 断 在 提炼 公共 方法 的 同时 学 习 如 何 写 出 适用 性 更 强 、 更 稳定 的 方法 ， 一 步 步 修炼 
脚本 的 语法 和 语义 ， 提 高 功力 。 


9o, 这 个 问题 暴露 了 最 根本 问题 : 自动 化 与 组 织 架构 有 没有 关系 ? 


21.3 自动 化 与 组 织 架构 有 没有 关系 





名 动 化 不 是 一 个 技术 问题 ， 而 是 一 个 配合 问题 。 不 是 千 某 个 技术 牛人 支撑 ， 而 是 车 整个 团队 推动。 
Zi 
A ax AMM RAHI: 自动 化 是 面向 管理 者 还 是 面向 从 业者 ? 


eO, as, 我 不 想 谈 所 谓 的 测试 成 熟 度 模型 ， 不 愿 聊 那 些 看 上 去 可 行 却 难以 应 用 到 实践 中 的 方法 和 技巧 ， 只 希望 说 说 入 行 至 今 此 消 彼 长 的 这 两 种 言论 一 一 执行 团队 不 断 强调 自动 化 工具 和 框架 要 做 
得 足够 傻瓜 ， 易 用 性 要 足够 强 。 
Se 


< 


全 惟 而 自动 化 团队 却 因为 这 般 而 叫苦 连天 : 说 到 底 ， 自 动 化 工具 和 框架 究竟 应 该 更 侧重 于 易 用 性 还 是 应 该 更 侧重 于 稳定 性 ? 
669, cosas: 要 兼顾 ! 


s» 
人 5 领导 说 的 自然 伟大 、 光 明 、 正 确 ， 似 乎 易 用 性 和 稳定 性 也 都 应 该 兼顾 ， 而 自动 化 工具 和 框架 的 门楼 也 理应 足够 做， 似乎 只 有 这 样 的 自动 化 才 是 好 的 自动 化 ， 只 有 这 样 的 工具 和 框架 才能 真正 让 别 的 测 
试 团队 接受 并 真正 投入 使 用 。 


, TTE HERFRA- RAL, KERERE X bb BOR ak dE SA e ME MR, KHRGGARARMAARAHARAM EH. CAKE, CEGKAARA 
地 “降低 门槛 ”而 苦 苦 挣 扎 、 浪 费时 间 ， 甚 至 最 终 因为 门槛 还 存在 而 最 终 搁 置 ? 

fo 

< 全 自动 化 的 推行 是 只 涉及 执行 团队 还 是 涉及 所 有 测试 团队 ， 甚 至 整个 研发 团队 (包括 测试 、 开 发 、 需 求 、 设 计 等 ) ? 

eo, 动 化 工具 的 使 用 范围 是 只 涉及 自动 化 团队 技术 人 员 的 推广 能 力 还 是 涉及 整个 组 织 架 构 的 合理 性 规划 ? 这 些 的 确 需要 进行 更 深入 的 讨论 和 深思 。 


b: 由 以 巴 哥 大 自 身 的 经 验 而 言 ， 一 款 优秀 的 自动 化 工具 或 框架 的 顺利 实施 ， 不 仅 涉及 工具 本 身 的 能 力 ， 更 涉及 从 工具 开发 人 员 到 工具 维护 人 员 ， 再 到 脚本 编写 人 员 再 到 脚本 维护 人 员 ， 最 后 到 脚本 执 
行人 员 这 一 串 炮 仗 能 否 连 环 响 。 


如 果 中 国 缺 少 某 类 人 员 ， 或 者 某 类 人 员 不够 称职 ， 那 一 款 自 动 化 工具 无 论 多 么 强大 ， 从 诞生 之 日 就 已 天 折 ， 更 别 亿 论 其 他 。 


附录 A monkey 常 用 键 值 参照 表 


$ 名 
KEYCODE 0 
KEYCODE 1 
KEYCODE 2 
KEYCODE 3 
KEYCODE 4 
KEYCODE 5 
KEYCODE 6 
KEYCODE 7 
KEYCODE 8 
KEYCODE 9 
KEYCODE A 
KEYCODE B 
KEYCODE C 
KEYCODE D 
KEYCODE E 
KEYCODE F 
KEYCODE G 
KEYCODE H 
KEYCODE I 


基本 键 
描 述 
按键 '0' 
按键 '1' 
按键 '2 
按键 '3' 
按键 '4' 
按键 '5 
按键 '6' 
按键 '7' 
按键 '8' 
按键 '9 
按键 'A' 
按键 'B' 
按键 'C' 
按键 'D' 
按键 'E' 
按键 下 ' 
按键 'G' 
按键 'H' 
Tus T 


9 名 
KEYCODE J 
KEYCODE K 
KEYCODE L 
KEYCODE M 
KEYCODE N 
KEYCODE O 
KEYCODE P 
KEYCODE Q 
KEYCODE R 
KEYCODE S 
KEYCODE T 
KEYCODE U 
KEYCODE V 
KEYCODE W 
KEYCODE X 
KEYCODE Y 
KEYCODE Z 


键 名 
KEYCODE CALL 
KEYCODE ENDCALL 
KEYCODE HOME 
KEYCODE MENU 
KEYCODE BACK 
KEYCODE SEARCH 
KEYCODE CAMERA 
KEYCODE FOCUS 
KEYCODE POWER 
KEYCODE NOTIFICATION 
KEYCODE MUTE 
KEYCODE VOLUME MUTE 
KEYCODE VOLUME UP 
KEYCODE VOLUME DOWN 


基本 键 
按键 'G' 
按键 'K' 
Tg 'L' 
按键 'M' 
按键 'N' 
按键 'O 
按键 'P' 
按键 'Q' 
按键 'R' 
按键 'S' 
按键 'T' 
按键 'U' 
按键 'V' 
按键 "W' 
按键 'X' 
按键 'Y' 
按键 'Z 


手机 键 
描 XN 
拨号 键 
挂机 键 
按键 Home 
菜单 键 


返回 键 


| 








拍照 刍 


~ M 
7 7 ^ 








区 
zm 
一 | 
em 


音量 减 小 键 





功能 键 











键 名 描 xA 
KEYCODE F1 按键 下 1 
KEYCODE F2 按键 F2 
KEYCODE F3 按键 F3 
KEYCODE F4 按键 F4 
KEYCODE F5 按键 FS 
KEYCODE F6 按键 F6 
KEYCODE F7 按键 F7 
KEYCODE F8 按键 F8 
KEYCODE F9 按键 F9 
KEYCODE F10 按键 F10 
KEYCODE Fl11 按键 Fl1 
KEYCODE F12 按键 F12 
符号 键 
键 名 描 述 
KEYCODE PLUS 按键 V 
KEYCODE MINUS 按键 号 
KEYCODE STAR dg e 
KEYCODE SLASH 按键 / 
KEYCODE EQUALS 按键 '=' 
KEYCODE AT 按键 '@ 
KEYCODE POUND 按键 ' H! 
KEYCODE APOSTROPHE 按键 " 
KEYCODE BACKSLASH 按键 " 
KEYCODE COMMA 按键 ， 
KEYCODE PERIOD 按键 '。， 
KEYCODE LEFT BRACKET 按键 '[ 
KEYCODE RIGHT BRACKET 按键 ' ] 
KEYCODE SEMICOLON 按键 '; 
KEYCODE GRAVE 按键 


KEYCODE SPACE 空格 键 


小 键盘 




















键 名 描 述 
KEYCODE NUMPAD 0 小 键盘 按键 '0' 
KEYCODE NUMPAD 1 小 键盘 按键 '1' 
KEYCODE NUMPAD 2 小 键盘 按键 '2 
KEYCODE NUMPAD 3 小 键盘 按键 '3 
KEYCODE NUMPAD 4 小 键盘 按键 4 
KEYCODE NUMPAD 5 小 键盘 按键 '5 
KEYCODE NUMPAD 6 小 键盘 按键 '6' 
KEYCODE NUMPAD 7 小 键盘 按键 '7' 
KEYCODE NUMPAD 8 小 键盘 按键 '8' 
KEYCODE NUMPAD 9 小 键盘 按键 '9' 
KEYCODE NUMPAD ADD 小 键盘 按键 + 
KEYCODE NUMPAD SUBTRACT 小 键盘 按键 |! 
KEYCODE NUMPAD MULTIPLY 小 键盘 按键 Un 
KEYCODE NUMPAD DIVIDE 小 键盘 按键 / 
KEYCODE NUMPAD EQUALS 小 键盘 按键 '=' 
KEYCODE NUMPAD COMMA 小 键盘 按键 '，' 
KEYCODE NUMPAD DOT 小 键盘 按键 '，' 
KEYCODE NUMPAD LEFT PAREN 小 键盘 按键 '(' 
KEYCODE NUMPAD RIGHT PAREN 小 键盘 按键 小 
KEYCODE NUMPAD ENTER 小 键盘 按键 回 车 

多 媒体 键 

键 名 fü xh 
KEYCODE MEDIA PLAY 多 媒体 键 播放 
KEYCODE MEDIA STOP 多 媒体 键 停止 
KEYCODE MEDIA PAUSE 多 媒体 键 和 暂停 
KEYCODE MEDIA PLAY PAUSE 多 媒体 键 播放 /暂停 
KEYCODE MEDIA FAST FORWARD 多 媒体 键 快 进 
KEYCODE MEDIA REWIND 多 媒体 键 快 退 
KEYCODE MEDIA NEXT 多 媒体 键 下 一 首 
KEYCODE MEDIA PREVIOUS 多 媒体 键 上 一 首 
KEYCODE MEDIA CLOSE 多 媒体 键 关闭 
KEYCODE MEDIA EJECT 多 媒体 键 弹出 
KEYCODE MEDIA RECORD 多 媒体 键 录 音 


键 名 
KEYCODE BUTTON 1 
KEYCODE BUTTON 2 
KEYCODE BUTTON 3 
KEYCODE BUTTON 4 
KEYCODE BUTTON 5 
KEYCODE BUTTON 6 
KEYCODE BUTTON 7 
KEYCODE BUTTON 8 
KEYCODE BUTTON 9 
KEYCODE BUTTON 10 
KEYCODE BUTTON 11 
KEYCODE BUTTON 12 
KEYCODE BUTTON 13 
KEYCODE BUTTON 14 
KEYCODE BUTTON 15 
KEYCODE BUTTON 16 
KEYCODE BUTTON A 
KEYCODE BUTTON B 
KEYCODE BUTTON C 
KEYCODE BUTTON X 
KEYCODE BUTTON Y 
KEYCODE BUTTON Z 
KEYCODE BUTTON LI 
KEYCODE BUTTON L2 
KEYCODE BUTTON RI 
KEYCODE BUTTON R2 
KEYCODE BUTTON MODE 
KEYCODE BUTTON SELECT 
KEYCODE BUTTON START 
KEYCODE BUTTON THUMBL 


KEYCODE BUTTON THUMBR 


键 名 
KEYCODE ALT LEFT 
KEYCODE ALT RIGHT 
KEYCODE CTRL-LEFT 
KEYCODE CTRL RIGHT 
KEYCODE SHIFT LEFT 
KEYCODE SHIFT RIGHT 


手柄 按键 


描 ik 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
通用 游戏 手柄 按钮 # 
游戏 手柄 按钮 A 
游戏 手柄 按钮 B 
游戏 手柄 按钮 C 
游戏 手柄 按钮 X 
游戏 手柄 按钮 Y 
游戏 手柄 按钮 Z 
游戏 手柄 按钮 L1 
游戏 手柄 按钮 L2 
游戏 手柄 按钮 R1 
游戏 手柄 按钮 R2 
游戏 手柄 按钮 Mode 
游戏 手柄 按钮 Select 
游戏 手柄 按钮 Start 
Left Thumb Button 


Right Thumb Button 


描 述 
Alt+Left 
Alt+Right 
Control+Letf 
Control+Right 
Shift+Letf 
Shitf+Right 


— 





附录 B getProperty0 和 getSystemProperty() 


P rt 
diea Property Description Notes 
Group 


ma | | 
io — — — — Asweisrmbererbd, — — 


Comma-separated tags that describe the build, such 
tags é . ” “ ” 
as "unsigned" and "debug" . 
build The build type,such as "user or “eng” . See Build 
a | LLL] 


The name of the native code instruction set,in the 
CPU ABI : 
= form CPU type plus ABI convention. 


The product/hardware manufacturer. 


2L The internal code used by the source control system 
version.increm ental : : 
to represent this version of the software. 


version.release The user-visible name of this version of the software. 


. The user-visible SDK version associated with this 
version.sdk . 
version of the OS. 
. The current development codename, or " REL " if 
version.codename . . 
this version of the software has been released. 





Propert 
perty Property Description Notes 
Group 


The device’s display width in pixels. 
The device’s display height in pixels. 


The logical density of the display. This is a factor 
that scales DIP(Density-Independent Pixel)units to 
the device’s resolution.DIP is adjusted so that 1 DIP 


; . . : . . See Display Metrics for 
display is equivalent to one pixel on a 160 pixel-per-inch 


details. 


density display. For example, on a 160-dpi screen, density — 


1.0, while on a 120-dpi screen,density —.75. 


The value does not exactly follow the real screen 
size,but is adjusted to conform to large changes in the 
display DPI. See density for more details. 


k The Android package name of the currently running 
ackage 
4 2 package. 


The current activity’s action. This has the same 
action format as the name attribute of the action element in a 


package manifest. 


The class name of the component that started the 
comp.class um ' 
current Activity. Seecomp. package for more details. The am.current keys 


The package name of the component that started | return information about the 





am.current 
the current Activity. A component is specified by a | currently-running Activity. 
comp.package 

package name and the name of class that the package 


contains. 


dan The data(if any) contained in the Intent that started 
ata 
the current Activity. 
. The categories specified by the Intent that started 
categories " 
the current Activity. 


: The number of milliseconds since the device 
realtime : : . 
rebooted, including deep-sleep time. 
= - - See System Clock for more 
clock . The number of milliseconds since the device | . . 
uptime : . . information 
rebooted, not including deep-sleep time 


current time since the UNIX epoch, in milliseconds. 


